Spring Boot加Kubernetes依赖启动失败 kubernetesPodUtils Bean冲突

报错的核心是Kubernetes相关依赖引入混乱，同时加载了两套互斥的Spring Cloud Kubernetes客户端实现，且版本不统一：

• Spring Cloud Kubernetes 存在两套独立的客户端实现，二者不能共存：
  • 基于Fabric8 Kubernetes Java客户端的旧实现，对应核心依赖为spring-cloud-starter-kubernetes、spring-cloud-kubernetes-core，自动配置类为org.springframework.cloud.kubernetes.KubernetesAutoConfiguration
  • 基于官方Kubernetes Java Client重构的新实现，对应核心依赖为spring-cloud-starter-kubernetes-client-all，自动配置类为org.springframework.cloud.kubernetes.client.KubernetesClientAutoConfiguration
• 你当前的依赖配置同时引入了两套实现的组件，还跨大版本混用了1.1.x、2.1.x的不同版本包，两个自动配置类都会向Spring容器注册同名的kubernetesPodUtils Bean。Spring Boot 2.1及以上版本默认禁止Bean定义覆盖，直接触发启动失败。
• 额外注意：如果不是刻意做双注册双发现场景，同时启用@EnableEurekaClient和K8s服务发现也会增加不必要的配置复杂度。

二选一保留一套Kubernetes客户端实现即可，禁止两套混引，所有相关依赖必须统一版本，不要零散引入单个模块包：

方案1：使用官方Kubernetes Java Client实现（当前社区维护主线，推荐） #

1. 清理pom中所有Fabric8系旧依赖，删除以下条目：

• 1.1.10.RELEASE版本的spring-cloud-kubernetes-config
• 1.1.10.RELEASE版本的spring-cloud-starter-kubernetes
• 1.1.10.RELEASE版本的spring-cloud-kubernetes-core
• 单独引入的2.1.3版本spring-cloud-kubernetes-discovery

2. 保留spring-cloud-starter-kubernetes-client-all依赖即可，这个全量starter已经包含了服务发现、配置加载、核心能力的所有相关依赖，不需要额外单独引入其他K8s相关组件。注意该依赖版本要和你项目使用的Spring Cloud大版本对齐，不要单独指定不匹配的版本。
3. 非双注册场景下，移除@EnableEurekaClient注解，仅保留@EnableDiscoveryClient、@EnableFeignClients即可。

方案2：使用Fabric8客户端实现（仅用于旧版本兼容场景） #

1. 删除spring-cloud-starter-kubernetes-client-all依赖，以及单独引入的2.1.3版本spring-cloud-kubernetes-discovery
2. 统一所有Kubernetes相关组件版本为1.1.10.RELEASE，引入Fabric8系的全量starter spring-cloud-starter-kubernetes-all即可，不需要零散引入config、core、discovery等单个模块包，避免版本错位。

临时绕过方案（不推荐生产使用） #

如果暂时无法清理依赖，可以通过配置开启Bean覆盖临时绕过启动报错：

spring:
  main:
    allow-bean-definition-overriding: true

该方案仅能掩盖启动报错，两套客户端同时加载后续大概率出现服务发现失败、配置读取错乱、调用链路异常等隐性问题，仅适合临时调试使用，生产环境必须清理依赖解决根因。

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