Spring Cloud 2025.1 与 Spring Boot 4 核心变化及开发实践

2. 公共依赖配置

创建父工程 spring-cloud-2025-demo，统一管理依赖版本，pom.xml 核心内容如下：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>4.0.0</version>
    <relativePath/>
</parent>
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2025.1.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <!-- 阿里云组件依赖 -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>2025.0.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3. 服务开发：用户服务（user-service）

3.1 依赖引入

<dependencies>
    <!-- 基础 Web 依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 服务注册发现 -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
    <!-- 链路追踪 -->
    <dependency>
        <groupId>org.apache.skywalking</groupId>
        <artifactId>skywalking-spring-boot-starter</artifactId>
        <version>10.2.0</version>
    </dependency>
</dependencies>

3.2 配置文件（application.yml）

spring:
  application:
    name: user-service # 服务名称（Nacos 注册名称）
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848 # Nacos 地址
        namespace: dev # 命名空间
    sentinel:
      transport:
        dashboard: localhost:8080 # Sentinel 控制台地址
  threads:
    virtual:
      enabled: true # 启用虚拟线程
server:
  port: 8081 # 服务端口
# 链路追踪配置
skywalking:
  agent:
    service-name: ${spring.application.name}
    collector.backend_service: localhost:11800

3.3 核心代码

// 启动类：使用简化注解
@SpringCloudApplication
public class UserServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
    }
}

// 控制层：提供用户查询接口
@RestController
@RequestMapping("/user")
public class UserController {
    // 模拟用户数据查询
    @GetMapping("/{id}")
    public ResponseEntity<User> getUserById(@PathVariable Long id) {
        // 构造用户数据
        User user = new User();
        user.setId(id);
        user.setName("Spring Cloud 2025 User");
        user.setPhone("13800138000");
        return ResponseEntity.ok(user);
    }
}

// 实体类
@Data
@NoArgsConstructor
@AllArgsConstructor
public class User {
    private Long id;
    private String name;
    private String phone;
}

4. 服务开发：订单服务（order-service）

4.1 依赖引入

在用户服务依赖基础上，新增配置中心与熔断限流依赖：

<!-- 配置中心 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
<!-- 熔断限流 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>
<!-- 服务调用（Feign） -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

4.2 配置文件

新增 bootstrap.yml（配置中心优先级高于 application.yml）：

spring:
  cloud:
    nacos:
      config:
        server-addr: localhost:8848
        namespace: dev
        group: DEFAULT_GROUP
        name: order-service # 对应 Nacos 中的配置名称
        file-extension: yaml # 配置文件格式
profiles:
  active: dev # 激活开发环境

Nacos 中 order-service-dev.yaml 配置内容：

server:
  port: 8082
# 自定义配置：订单超时时间
order:
  timeout: 3000
  max-count: 1000

4.3 核心代码

// 启动类：开启 Feign 客户端
@SpringCloudApplication
@EnableFeignClients // 启用 Feign 服务调用
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

// Feign 客户端：调用用户服务
@FeignClient(name = "user-service") // 对应用户服务名称
@SentinelResource(value = "userServiceClient", fallback = UserServiceFallback.class) // 熔断降级配置
public interface UserServiceClient {
    @GetMapping("/user/{id}")
    ResponseEntity<User> getUserById(@PathVariable("id") Long id);
}

// 熔断降级实现类
@Component
public class UserServiceFallback implements UserServiceClient {
    @Override
    public ResponseEntity<User> getUserById(Long id) {
        // 降级逻辑：返回默认用户信息
        User defaultUser = new User(id, "默认用户（服务降级）", "12345678901");
        return ResponseEntity.ok(defaultUser);
    }
}

// 配置类：注入自定义配置
@Configuration
@ConfigurationProperties(prefix = "order") // 绑定 Nacos 中的 order 前缀配置
@Data
public class OrderConfig {
    private Integer timeout;
    private Integer maxCount;
}

// 控制层：订单接口
@RestController
@RequestMapping("/order")
public class OrderController {
    @Autowired
    private UserServiceClient userServiceClient;
    @Autowired
    private OrderConfig orderConfig;

    // 创建订单接口：调用用户服务获取用户信息
    @GetMapping("/create")
    @SentinelResource(value = "createOrder", blockHandler = "createOrderBlockHandler") // 限流处理
    public ResponseEntity<Order> createOrder(@RequestParam Long userId) {
        // 调用用户服务
        ResponseEntity<User> userResp = userServiceClient.getUserById(userId);
        // 构造订单信息
        Order order = new Order();
        order.setOrderId(System.currentTimeMillis());
        order.setUserId(userId);
        order.setUserName(userResp.getBody().getName());
        order.setTimeout(orderConfig.getTimeout());
        return ResponseEntity.ok(order);
    }

    // 限流处理方法（参数需与原方法一致，末尾加 BlockException）
    public ResponseEntity<Order> createOrderBlockHandler(Long userId, BlockException e) {
        Order limitOrder = new Order();
        limitOrder.setOrderId(0L);
        limitOrder.setMsg("订单创建失败：当前请求量过大，请稍后再试");
        return ResponseEntity.ok(limitOrder);
    }
}

// 订单实体类
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Order {
    private Long orderId;
    private Long userId;
    private String userName;
    private Integer timeout;
    private String msg;
}

5. 功能验证与监控

5.1 服务注册验证

启动 user-service 与 order-service 后，访问 Nacos 控制台（http://localhost:8848/nacos），在'服务管理 - 服务列表'中可看到两个服务均已注册，状态为'健康'。

5.2 接口调用验证

访问订单创建接口：http://localhost:8082/order/create?userId=1，正常返回：

{"orderId":1730300000000,"userId":1,"userName":"Spring Cloud 2025 User","timeout":3000,"msg":null}

停止 user-service 后再次调用，触发熔断降级，返回：

{"orderId":1730300000001,"userId":1,"userName":"默认用户（服务降级）","timeout":3000,"msg":null}

5.3 限流与链路追踪验证

• 限流验证：在 Sentinel 控制台（http://localhost:8080）为'createOrder'资源设置限流规则（如 QPS=5），快速调用接口超过阈值后，返回限流提示。
• 链路追踪验证：访问 SkyWalking UI（http://localhost:8080），在'服务拓扑图'中可看到 user-service 与 order-service 的调用关系，'追踪'模块可查看完整调用链路、耗时等信息。

三、核心升级亮点总结

1. 性能提升：虚拟线程大幅降低高并发场景下的线程开销，HTTP/3 协议提升服务通信效率。
2. 生态简化：淘汰过时组件，统一阿里生态为官方推荐，降低技术选型成本。
3. 运维智能化：SkyWalking 全链路追踪 +Sentinel 动态限流，结合 Nacos 配置溯源，实现问题快速定位。
4. 开发高效化：简化注解、本地调试支持、测试注解等优化，提升开发与调试效率。