跳至主要內容

微服务架构演进：从Spring Cloud 2021到2023的重大变化与迁移指南

老张2026/4/30大约 9 分钟

微服务架构演进：从Spring Cloud 2021到2023的重大变化与迁移指南

适读人群：正在使用或计划升级Spring Cloud的后端工程师 | 阅读时长：约28分钟 | Spring Boot 3.2 / Spring Cloud 2023.0

开篇故事

上个月有个读者给我发消息，说他们公司的项目还在用Spring Cloud Hoxton + Spring Boot 2.3，想升级到最新版，但是项目里用了大量Hystrix、Zuul、Spring Cloud Sleuth，一查文档发现这些东西在新版本里全都被删掉或者替换了，不知道从哪里下手，感觉像是在重写系统。

这个担忧我非常理解，我自己也经历过这个升级过程。2021年那次从Greenwich系列升到2020.x是一次大手术，Hystrix换成了Resilience4j，Ribbon换成了Spring Cloud LoadBalancer，Sleuth还在但API有变化。2023年Spring Boot升到3.x，Sleuth又从Spring Cloud移出去了，换成了Micrometer Tracing……

每一次升级都有破坏性变更，但每次升级后系统也确实变得更简洁了。今天我从头到尾梳理一下Spring Cloud这几年的重大变化，给出一个完整的迁移路径，让升级不再那么痛苦。

一、核心问题分析

Spring Cloud的版本演进经历了几个重要里程碑，每次里程碑都带来了一些被废弃组件的替换：

Spring Cloud 2020.x（Ilford，基于Spring Boot 2.4）：

  • 正式废弃Ribbon（替换为Spring Cloud LoadBalancer）
  • 正式废弃Hystrix（替换为Spring Cloud CircuitBreaker + Resilience4j）
  • Feign集成从spring-cloud-openfeign继续，但配置方式有变化

Spring Cloud 2021.x（Jubilee，基于Spring Boot 2.6）：

  • Zuul 1.x继续废弃（官方已不维护，Spring Cloud Gateway是推荐替代）
  • Spring Cloud Sleuth继续维护但宣布最终版本，下一阶段迁移到Micrometer Tracing
  • Spring Cloud Config Server改进了多仓库支持

Spring Cloud 2022.x（Kilburn，基于Spring Boot 3.0）：

  • Spring Boot 3.x要求Java 17，Jakarta EE命名空间（javax.* → jakarta.*）
  • Spring Cloud Sleuth被彻底移除，由Micrometer Tracing接管
  • Spring Security 6.x重大变化（WebSecurityConfigurerAdapter被删除）

Spring Cloud 2023.x（目前最新，基于Spring Boot 3.2）：

  • 正式支持Java 21虚拟线程（Project Loom）
  • GraalVM Native Image支持成熟
  • 响应式和命令式混用的能力增强

二、原理深度解析

2.1 Spring Cloud版本演进时间线

2.2 组件替换映射

2.3 迁移路径规划

三、完整代码实现

3.1 依赖对比（旧版 vs 新版）

<!-- 旧版本依赖（Spring Boot 2.x + Spring Cloud Hoxton） -->
<dependencies>
    <!-- 已废弃：不要再用 -->
    <!-- <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-sleuth</artifactId>
    </dependency> -->
</dependencies>

<!-- 新版本依赖（Spring Boot 3.2 + Spring Cloud 2023.0） -->
<dependencies>
    <!-- Spring Cloud LoadBalancer（替代Ribbon） -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-loadbalancer</artifactId>
    </dependency>
    <!-- Resilience4j（替代Hystrix） -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-circuitbreaker-resilience4j</artifactId>
    </dependency>
    <!-- Spring Cloud Gateway（替代Zuul） -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>
    <!-- Micrometer Tracing（替代Sleuth） -->
    <dependency>
        <groupId>io.micrometer</groupId>
        <artifactId>micrometer-tracing-bridge-brave</artifactId>
    </dependency>
    <dependency>
        <groupId>io.zipkin.reporter2</groupId>
        <artifactId>zipkin-reporter-brave</artifactId>
    </dependency>
</dependencies>

3.2 Hystrix迁移到Resilience4j

// 旧版本：Hystrix注解
// @HystrixCommand(fallbackMethod = "fallback")
// public String getData() { ... }

// 新版本：Resilience4j注解
@CircuitBreaker(name = "order-service", fallbackMethod = "fallback")
@Retry(name = "order-service")
@TimeLimiter(name = "order-service")
public CompletableFuture<String> getData() {
    return CompletableFuture.supplyAsync(() -> {
        // 业务逻辑
        return orderServiceClient.getData();
    });
}

public CompletableFuture<String> fallback(Throwable t) {
    return CompletableFuture.completedFuture("降级响应");
}
# Resilience4j配置（替代Hystrix配置）
resilience4j:
  circuitbreaker:
    instances:
      order-service:
        slidingWindowSize: 20
        failureRateThreshold: 50
        waitDurationInOpenState: 30s
  timelimiter:
    instances:
      order-service:
        timeout-duration: 5s
  retry:
    instances:
      order-service:
        maxAttempts: 3
        waitDuration: 500ms

3.3 Ribbon迁移到Spring Cloud LoadBalancer

// 旧版本：不需要额外配置，@LoadBalanced RestTemplate会自动用Ribbon

// 新版本：Spring Cloud LoadBalancer自动接管
// 只需要确保没有Ribbon依赖，LoadBalancer会自动使用
@Bean
@LoadBalanced  // 这个注解在新版本里继续有效
public RestTemplate restTemplate() {
    return new RestTemplate();
}

// 关键配置：关闭Ribbon（如果依赖树里还有Ribbon）
// spring.cloud.loadbalancer.ribbon.enabled=false

3.4 Spring Security 6.x迁移（Java配置变化）

// 旧版本：继承WebSecurityConfigurerAdapter（已删除）
// @Configuration
// public class SecurityConfig extends WebSecurityConfigurerAdapter {
//     @Override
//     protected void configure(HttpSecurity http) throws Exception { ... }
// }

// 新版本：直接声明SecurityFilterChain Bean
@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            .csrf(csrf -> csrf.disable())
            .sessionManagement(session ->
                session.sessionCreationPolicy(SessionCreationPolicy.STATELESS)
            )
            .authorizeHttpRequests(auth -> auth
                .requestMatchers("/auth/**", "/public/**").permitAll()
                .anyRequest().authenticated()
            )
            .addFilterBefore(jwtAuthFilter, UsernamePasswordAuthenticationFilter.class);
        return http.build();
    }

    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }
}

3.5 javax到jakarta命名空间迁移

// 旧版本（javax）
// import javax.servlet.http.HttpServletRequest;
// import javax.persistence.Entity;
// import javax.validation.constraints.NotNull;

// 新版本（jakarta）
import jakarta.servlet.http.HttpServletRequest;
import jakarta.persistence.Entity;
import jakarta.validation.constraints.NotNull;

可以用IntelliJ IDEA的迁移工具自动处理： Refactor → Migrate Packages and Classes → Java EE to Jakarta EE

3.6 Feign配置变化

// 旧版本：@FeignClient的fallback写法
// Spring Cloud 2020之前
@FeignClient(name = "order-service", fallback = OrderServiceFallback.class)

// 新版本推荐：使用FallbackFactory（可以获取异常信息）
@FeignClient(
    name = "order-service",
    fallbackFactory = OrderServiceFallbackFactory.class
)
public interface OrderServiceClient { ... }

// 新版本中FeignClient配置属性变化
// spring.cloud.openfeign.circuitbreaker.enabled=true（替代feign.hystrix.enabled）

3.7 Micrometer Tracing API变化

// 旧版本（Spring Cloud Sleuth）
// import org.springframework.cloud.sleuth.Span;
// import org.springframework.cloud.sleuth.Tracer;

// @Autowired
// private Tracer tracer;
// Span span = tracer.nextSpan().name("my-span").start();

// 新版本（Micrometer Tracing）
import io.micrometer.tracing.Span;
import io.micrometer.tracing.Tracer;

@Autowired
private Tracer tracer;

Span span = tracer.nextSpan().name("my-span").start();
try (Tracer.SpanInScope ws = tracer.withSpan(span)) {
    // 业务逻辑
} finally {
    span.end();
}

3.8 虚拟线程配置（Java 21 + Spring Boot 3.2）

# 开启虚拟线程支持（需要Java 21）
spring:
  threads:
    virtual:
      enabled: true  # 开启后，Tomcat、定时任务等都会使用虚拟线程

虚拟线程对IO密集型微服务有显著的性能提升，原来需要配置大线程池的地方，现在可以大幅减少线程池配置：

// 开启虚拟线程后，可以大幅简化线程池配置
// 虚拟线程的创建和切换开销极低，不需要池化管理
@Configuration
public class VirtualThreadConfig {

    @Bean
    public Executor taskExecutor() {
        // 使用虚拟线程执行器
        return Executors.newVirtualThreadPerTaskExecutor();
    }
}

四、生产配置与调优

4.1 升级检查清单

阶段一：升级Spring Boot 2.x到3.x
✅ Java版本升级到17（最低要求）
✅ javax.* 改为 jakarta.*
✅ WebSecurityConfigurerAdapter 迁移到SecurityFilterChain
✅ Spring Data JPA命名查询变更
✅ application.properties中废弃属性处理

阶段二：迁移Spring Cloud组件
✅ 移除Ribbon依赖，确认LoadBalancer生效
✅ 移除Hystrix，迁移到Resilience4j
✅ 移除Zuul，迁移到Gateway
✅ 移除Sleuth，配置Micrometer Tracing
✅ Feign配置更新（circuitbreaker.enabled）

阶段三：验证
✅ 所有单元测试通过
✅ 集成测试通过
✅ 压测性能不低于迁移前
✅ 监控指标正常（TraceId传播、熔断指标等）

4.2 迁移中的兼容性问题处理

<!-- 如果有第三方库还依赖Ribbon，强制排除 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
        </exclusion>
    </exclusions>
</dependency>

五、踩坑实录

坑一：升级后Feign熔断全部失效，Hystrix配置不再起作用。

升级到新版本后，之前的feign.hystrix.enabled=true配置无效了，Feign熔断相当于关闭了。新版本需要配置spring.cloud.openfeign.circuitbreaker.enabled=true才能开启Feign的熔断支持，并且熔断器实现变成了Resilience4j而不是Hystrix。

坑二：javax.servlet. 类找不到，编译失败。*

Spring Boot 3.x使用Jakarta EE 9+，所有javax.servlet.*改为了jakarta.servlet.*。如果项目里有自定义Filter、Interceptor、Servlet，必须批量修改import语句。IDEA的迁移工具可以自动处理大部分，但自己写的一些工具类可能会遗漏。

坑三：Micrometer Tracing的日志格式和旧版Sleuth不一样。

Sleuth在日志里输出的格式是[serviceName, traceId, spanId, exportable]，Micrometer Tracing的格式是[serviceName, traceId, spanId]。如果ELK有解析Sleuth格式日志的Logstash管道，需要更新解析规则。

坑四：开启虚拟线程后，某些ThreadLocal相关逻辑失效。

虚拟线程的ThreadLocal行为和平台线程一致，但某些框架（尤其是老版本的）假设"一个请求对应一个固定的线程"，在虚拟线程模式下这个假设可能不成立。比如某些TreadLocal在一个请求的生命周期内被设置在虚拟线程A，但后续处理可能在虚拟线程B上运行。

建议开启虚拟线程后充分测试，特别是涉及ThreadLocal的代码路径（用户上下文、MDC日志、数据库事务等）。

坑五：GraalVM Native Image打包失败，反射调用找不到类。

GraalVM Native Image要求在编译期知道所有反射使用的类。很多Spring Boot的魔法（动态代理、反射实例化）需要提前配置reflect-config.json。Spring Boot 3.x对Native Image支持大幅改进，但第三方库的支持仍然参差不齐，不是所有库都能直接打成Native Image。

如果你的目标是打Native Image，需要提前验证所有依赖库是否支持，不支持的要找替代库或者手动添加反射配置。

六、总结

这20篇文章从Spring Cloud Gateway的过滤器到微服务架构的整体演进，覆盖了微服务进阶实战的核心话题。最后这篇关于版本迁移的文章，是很多人面临的最现实的问题。

升级的关键原则：不要一步到位（先升Boot 3.x，再迁移Spring Cloud组件，分步验证），核心组件逐一替换（每次只换一个，充分测试后再换下一个），保持充分的测试覆盖（单元测试+集成测试是升级的安全网）。

Spring Cloud这几年的演进方向是越来越标准化、越来越少"私有化"：Ribbon → 标准LoadBalancer，Hystrix → 标准CircuitBreaker，Sleuth → 标准Micrometer Tracing。这个方向是对的，升级后的系统更接近标准Java生态，依赖更轻，和其他工具的集成更顺畅。

这20篇从实战出发，每篇都有真实踩坑经验，希望对你有帮助。如果你有具体问题，欢迎在公众号后台留言。

编辑此页
最近更新:
贡献者: xiaozhangge