升级Spring Boot及Cloud后报discovery-server-url配置无效异常如何解决

触发场景 #

执行以下依赖升级操作后，服务启动抛出旧版本从未出现的Kubernetes相关报错：

• Spring Boot 从 2.3.12.RELEASE 升级至 2.7.0
• Spring Cloud 从 Hoxton.Release 升级至 2021.0.3

核心异常栈信息：

nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'compositeDiscoveryClient' defined in class path resource [org/springframework/cloud/client/discovery/composite/CompositeDiscoveryClientAutoConfiguration.class]: Unsatisfied dependency expressed through method 'compositeDiscoveryClient' parameter 0; 

nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'kubernetesDiscoveryClient' defined in class path resource [org/springframework/cloud/kubernetes/discovery/KubernetesDiscoveryClientAutoConfiguration$Servlet.class]: Bean instantiation via factory method failed; 

nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [org.springframework.cloud.client.discovery.DiscoveryClient]: Factory method 'kubernetesDiscoveryClient' threw exception; 

nested exception is org.springframework.cloud.kubernetes.discovery.DiscoveryServerUrlInvalidException: spring.cloud.kubernetes.discovery-server-url must be specified and a valid URL.

公开技术教程大多围绕@EnableDiscoveryClient注解使用、Controller层注入DiscoveryClient等基础用法展开，未提及该配置项的相关说明。

报错根因 #

Spring Cloud 2020.x及后续版本（含当前使用的2021.0.3）对Spring Cloud Kubernetes模块做了架构拆分，服务发现能力分为两种独立模式：

• 胖客户端模式：应用直接与Kubernetes API Server交互完成服务发现，是Hoxton及更早版本的默认实现逻辑
• 瘦客户端模式：独立部署Spring Cloud Kubernetes Discovery Server服务，所有业务服务通过HTTP调用该服务完成服务发现，该模式强制要求配置spring.cloud.kubernetes.discovery-server-url参数指定发现服务地址

当前依赖默认引入了瘦客户端模式的自动配置，但未做对应参数配置，因此触发启动校验失败。

修复方案 #

根据实际业务场景三选一即可：

方案1：不使用Kubernetes服务发现 #

如果服务采用Nacos、Eureka等其他注册中心，Kubernetes相关依赖为传递依赖引入、无实际使用需求，直接关闭Kubernetes服务发现自动配置即可。
在application.yml中添加配置：

spring:
  cloud:
    kubernetes:
      enabled: false
      discovery:
        enabled: false

也可直接在启动类上排除对应自动配置：

@SpringBootApplication(exclude = {
    org.springframework.cloud.kubernetes.discovery.KubernetesDiscoveryClientAutoConfiguration.class,
    org.springframework.cloud.kubernetes.commons.KubernetesCommonsAutoConfiguration.class
})
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

方案2：使用Kubernetes原生服务发现（兼容旧版本逻辑） #

如果需要沿用旧版本直接调用Kubernetes API的服务发现逻辑，将依赖中的瘦客户端starter替换为胖客户端对应starter即可，无需配置discovery-server-url参数，只需保证部署在K8s中的服务ServiceAccount拥有读取Pod、Service资源的RBAC权限。
Maven依赖替换示例：

<!-- 排除/移除瘦客户端依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-kubernetes-client-discovery</artifactId>
</dependency>
<!-- 引入胖客户端依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-kubernetes-fabric8</artifactId>
</dependency>

方案3：采用瘦客户端部署架构 #

如果架构中已经独立部署了Spring Cloud Kubernetes Discovery Server服务，直接在配置文件中指定该服务的可访问地址即可：

spring:
  cloud:
    kubernetes:
      discovery:
        discovery-server-url: http://{k8s-discovery-server实际部署地址}

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