You need to enable JavaScript to run this app. 升级spring-cloud-netflix 2.2.7.RELEASE后Eureka-Ribbon集成失效及依赖冲突咨询
优惠活动
大模型
产品
解决方案
定价
更多

升级spring-cloud-netflix 2.2.7.RELEASE后Eureka-Ribbon集成失效及依赖冲突咨询

spring-cloud-netflix版本升级后Ribbon无可用服务节点问题

问题现象

  • 团队将spring-cloud-netflix系列库从2.2.2.RELEASE升级到2.2.7.RELEASE,未预期会出现重大兼容问题,但测试环境持续抛出Ribbon负载均衡无可用服务的错误,错误栈如下:
Caused by: com.netflix.client.ClientException: Load balancer does not have available server for client: dummy-service
at com.netflix.loadbalancer.LoadBalancerContext.getServerFromLoadBalancer(LoadBalancerContext.java:483) ~[ribbon-loadbalancer-2.3.0.jar:2.3.0]
at com.netflix.loadbalancer.reactive.LoadBalancerCommand$1.call(LoadBalancerCommand.java:184) ~[ribbon-loadbalancer-2.3.0.jar:2.3.0]
at com.netflix.loadbalancer.reactive.LoadBalancerCommand$1.call(LoadBalancerCommand.java:180) ~[ribbon-loadbalancer-2.3.0.jar:2.3.0]
  • 配套使用的API网关组件为同版本的Netflix Zuul,对应依赖为spring-cloud-starter-netflix-zuul:2.2.7.RELEASE。

问题定位线索

  • 调试代码时发现,DynamicServerListLoadBalancer中的ServerList属性实际实现类为ConfigurationBasedServerList,并非预期的DomainExtractingServerList(该类本应包装DiscoveryEnabledNIWSServerList实现Eureka服务列表拉取),该行为与Spring Cloud官方文档描述的预期行为矛盾。

官方文档对应行为说明:当Eureka与Ribbon结合使用(即二者都在类路径下)时,ribbonServerList会被DiscoveryEnabledNIWSServerList的扩展实现覆盖,从Eureka拉取并填充服务列表;同时IPing接口会被替换为NIWSDiscoveryPing,由Eureka判断服务是否可用,默认安装的ServerList实现为DomainExtractingServerList。

  • 排查Maven依赖链路发现,spring-cloud-starter-netflix-eureka-client:jar:2.2.7.RELEASE会传递引入spring-cloud-netflix-eureka-client:jar:3.0.2,而该3.0.2版本缺失EurekaRibbonClientConfiguration和DomainExtractingServerList类,依赖链路如下:
+- org.springframework.cloud:spring-cloud-starter-netflix-eureka-client:jar:2.2.7.RELEASE:compile
[INFO] |  +- org.springframework.cloud:spring-cloud-netflix-hystrix:jar:2.2.7.RELEASE:compile
[INFO] |  +- org.springframework.cloud:spring-cloud-netflix-eureka-client:jar:3.0.2:compile

遇到的疑问与尝试

  • 这种2.x版本starter传递引入3.x核心库的跨版本兼容设计,是否是Spring Cloud官方的预期行为?
  • 原本预期2.x的starter可以兼容传递引入的3.x版本库,但实际运行结果不符合预期。尝试在pom文件中显式引入spring-cloud-netflix-eureka-client:jar:2.2.7.RELEASE覆盖3.0.2版本,反而触发类定义找不到的错误。
  • 当前技术栈存在严格限制:无法升级使用3.0.2版本组件,因为配套的spring-cloud-zuul最高维护版本仅为2.2.7.RELEASE,且必须继续使用Spring Cloud、Zuul、Ribbon、Eureka这套技术栈,无法切换替代方案。
  • 待解疑问:该场景下的可行解决方案是什么?是否需要在应用内自定义EurekaRibbonClientConfiguration类来注入正确的ServerList实现?但已知EurekaRibbonClientConfiguration除了创建ServerList Bean外还包含其他逻辑,自定义实现的成本和风险无法预估。

当前使用的项目pom配置

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.cdm</groupId>
    <artifactId>api-internal-gateway</artifactId>
    <version>${default.version}</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.4</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <default.version>DEV-SNAPSHOT</default.version>
        <java.version>11</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <spring-cloud.version>2020.0.2</spring-cloud.version>
        <springfox.version>2.9.2</springfox.version>
        <spring-cloud.extras.version>2.2.7.RELEASE</spring-cloud.extras.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>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-sleuth</artifactId>
            <version>${spring-cloud.extras.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
            <version>${spring-cloud.extras.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
            <version>${spring-cloud.extras.version}</version>
        </dependency>

        <dependency>
            <groupId>org.mockito</groupId>
            <artifactId>mockito-core</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.mockito</groupId>
            <artifactId>mockito-all</artifactId>
            <version>2.0.2-beta</version>
            <scope>test</scope>
        </dependency>
        
        <!-- API -->
        <dependency>
          <groupId>jakarta.xml.ws</groupId>
          <artifactId>jakarta.xml.ws-api</artifactId>
          <version>2.3.2</version>
        </dependency>
        <!-- Runtime -->
        <dependency>
          <groupId>com.sun.xml.ws</groupId>
          <artifactId>jaxws-rt</artifactId>
          <version>2.3.2</version>
        </dependency>
        <dependency>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
            <version>2.3.1</version>
        </dependency>
        <dependency>
            <groupId>javax.annotation</groupId>
            <artifactId>javax.annotation-api</artifactId>
            <version>1.3.1</version>
        </dependency>
        <dependency>
            <groupId>com.google.code.findbugs</groupId>
            <artifactId>jsr305</artifactId>
            <version>3.0.2</version>
        </dependency>
        <dependency>
            <groupId>javax.transaction</groupId>
            <artifactId>javax.transaction-api</artifactId>
            <version>1.2</version>
        </dependency>
    </dependencies>
</project>

内容的提问来源于stack exchange,提问作者Zain Qazi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 09:27:00