Spring Cloud 2025.1.2 (Oakwood) 发布：升级要点与实战配置

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <!-- Spring Boot 3.4.2 是 Oakwood 2025.1.2 对齐的基座版本 -->
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.4.2</version>
        <relativePath/>
    </parent>

    <groupId>com.example</groupId>
    <artifactId>oakwood-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>Oakwood Demo</name>

    <properties>
        <java.version>21</java.version>
        <!-- Oakwood 2025.1.2 BOM -->
        <spring-cloud.version>2025.1.2</spring-cloud.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <!-- Gateway -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-gateway-server-mvc</artifactId>
        </dependency>
        <!-- 服务发现（以 Eureka 为例，生产可换 Consul / K8s） -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <!-- Actuator 用于健康检查 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

server:
  port: 8080

spring:
  application:
    name: oakwood-gateway
  cloud:
    gateway:
      mvc:
        routes:
          - id: user-service
            uri: lb://user-service
            predicates:
              - Path=/api/users/**
            filters:
              - name: Retry
                args:
                  retries: 3
                  statuses: BAD_GATEWAY,GATEWAY_TIMEOUT
                  methods: GET,POST
                  backoff:
                    firstBackoff: 100ms
                    maxBackoff: 500ms
                  # 2025.1.2 修复了 Retry 过滤器与 LoadBalancer 的交互顺序
          - id: order-service
            uri: lb://order-service
            predicates:
              - Path=/api/orders/**

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/
    healthcheck:
      enabled: true
  instance:
    prefer-ip-address: true

management:
  endpoints:
    web:
      exposure:
        include: health,info,gateway

# 启动 Gateway 后，检查 Actuator 中的路由定义
curl -s http://localhost:8080/actuator/gateway/routes | python3 -m json.tool

# 期望输出类似：
# [
#   {
#     "route_id": "user-service",
#     "route_definition": { "predicate": "Path=/api/users/**", ... },
#     "order": 0
#   },
#   ...
# ]