处理LoadBalancerAutoConfiguration.loadBalancerClientFactory条件时发生异常

排查方向 #

• 核对Spring Boot与Spring Cloud版本兼容性：Spring Boot 2.7.x系列必须搭配Spring Cloud 2021.0.x（Jubilee版本），版本不匹配会直接引发类依赖缺失或不兼容问题。
• 确认Load Balancer依赖状态：检查项目依赖配置，确保spring-cloud-starter-loadbalancer已正确引入，且未被其他依赖（如Eureka的Ribbon）意外排除。
• 排查类加载冲突：通过依赖树命令查看是否存在多版本的spring-cloud-loadbalancer或Spring核心组件，版本冲突会导致类加载混乱，反射内省失败。
• 验证JDK版本：Spring Boot 2.7.x仅支持JDK 8、11、17，过高或过低的JDK版本会触发反射API的兼容性问题。

解决方法 #

• 对齐版本号：将Spring Cloud依赖版本调整为与Spring Boot 2.7.3匹配的2021.0.4，修改pom.xml的依赖管理节点：

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

• 显式引入Load Balancer并排除冲突依赖：如果使用Eureka客户端，需排除默认引入的Ribbon，替换为Spring Cloud LoadBalancer：

  <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-loadbalancer</artifactId>
  </dependency>
  <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.springframework.cloud</groupId>
              <artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 清理冲突依赖：执行mvn dependency:tree（Maven）或./gradlew dependencies（Gradle）查看依赖树，找出重复或不兼容的组件，通过exclusions标签排除冗余依赖。
• 调整JDK环境：将项目编译和运行的JDK版本切换到8、11或17，确保与Spring Boot 2.7.x兼容。
• 重建项目：执行mvn clean install或./gradlew clean build清理缓存，重新编译构建，消除旧文件残留问题。

内容的提问来源于stack exchange，提问作者Shubham Parmar