Spring Cloud Netflix 中 Eureka 与 LoadBalancer 的循环依赖问题解析

问题背景

在 Spring Cloud Netflix 生态系统中，Eureka 作为服务发现组件与 LoadBalancer 作为客户端负载均衡器的组合是微服务架构中的常见搭配。然而在最新版本中，开发者可能会遇到一个棘手的启动异常："Error creating bean with name 'scopedTarget.eurekaClient': Requested bean is currently in creation"。

问题本质

这个问题的根源在于 Spring Cloud Netflix 4.2.0-RC1 版本中引入的一项变更：默认使用 RestClient.Builder 作为 Eureka 通信的实现方式。当应用启动时，系统会尝试寻找 RestClient.Builder 或 RestClient bean 来与 Eureka 服务器建立连接。

关键问题在于：

1. 系统中唯一可用的 RestClient.Builder 是经过负载均衡处理的
2. Eureka 客户端本身需要的是一个普通的、非负载均衡的 RestClient.Builder
3. 这导致了循环依赖 - Eureka 客户端需要 RestClient 来初始化，而 LoadBalancer 又需要 Eureka 客户端来获取服务实例

技术细节分析

在微服务启动过程中，以下组件形成了复杂的依赖链：

1. EurekaClient 需要初始化并注册到 Eureka Server
2. 初始化过程需要使用 HTTP 客户端(RestClient)
3. 如果系统中只有一个负载均衡的 RestClient.Builder
4. 这个负载均衡的 RestClient 又需要 EurekaClient 来解析服务地址
5. 形成了 EurekaClient → RestClient → EurekaClient 的循环依赖

解决方案

开发团队提供了两种解决这一问题的方案：

方案一：显式配置多个 RestClient.Builder

@SpringBootApplication
public class Application {
    
    // 负载均衡的 RestClient.Builder
    @LoadBalanced
    @Bean
    RestClient.Builder lbRestClientBuilder() {
        return RestClient.builder();
    }

    // 普通的 RestClient.Builder，标记为@Primary
    @Primary
    @Bean
    RestClient.Builder restClientBuilder() {
        return RestClient.builder();
    }
}

在使用时，通过@LoadBalanced注解明确指定需要使用负载均衡的客户端：

@Controller
public class HelloController {
    
    @Autowired
    @LoadBalanced
    RestClient.Builder restClientBuilder;
    
    // 控制器方法
}

方案二：回退到传统HTTP客户端

在配置文件中添加：

eureka.client.restclient.enabled=false

这将使Eureka客户端回退到使用传统的HTTP客户端实现，而非RestClient。

架构决策与未来方向

Spring Cloud团队经过讨论后决定：

1. 在当前版本中恢复默认配置，不再默认使用RestClient实现
2. 将这一变更推迟到下一个主要版本中实施
3. 考虑提供更明确的方式来指定RestClient.Builder的使用
4. 可能实现自定义的RestClient实例创建逻辑

最佳实践建议

对于生产环境，建议：

1. 明确区分负载均衡和非负载均衡的HTTP客户端
2. 考虑使用Caffeine缓存替代默认缓存实现
3. 在升级版本时注意相关配置变更
4. 监控服务发现和负载均衡组件的初始化过程

这一问题的出现和解决过程展示了Spring Cloud生态系统中组件间复杂的交互关系，也体现了框架设计者在保持向后兼容性和推动技术演进之间的权衡。