Spring Cloud Kubernetes应用启动失败求助：Bean冲突问题

环境与依赖 #

• JDK 17
• spring-boot-starter-parent 3.1.3
• spring-cloud-dependencies
• spring-cloud-starter-kubernetes-fabric8-config
• spring-cloud-starter-bootstrap

启动报错信息 #

***************************
APPLICATION FAILED TO START
***************************

Description:

Parameter 2 of method configMapPropertyChangeEventWatcher in org.springframework.cloud.kubernetes.fabric8.config.reload.Fabric8ConfigReloadAutoConfiguration required a single bean,
 but 2 were found:
    - configDataConfigMapPropertySourceLocator: a programmatically registered singleton 
    - configMapPropertySourceLocator: defined by method 'configMapPropertySourceLocator' 
    in class path resource [org/springframework/cloud/kubernetes/fabric8/config/Fabric8BootstrapConfiguration.class]


Action:

Consider marking one of the beans as @Primary, updating the consumer to accept multiple beans, or using @Qualifier to identify the bean that should be consumed
","context":"default"}

当前配置文件 #

bootstrap.properties #

spring.cloud.bootstrap.enabled=true
spring.main.cloud-platform=KUBERNETES
spring.cloud.kubernetes.discovery.enabled=false
spring.cloud.kubernetes.config.enabled=true
spring.cloud.kubernetes.reload.enabled=true
spring.cloud.kubernetes.secrets.enabled=true
spring.cloud.kubernetes.reload.monitoring-secrets=true

application.properties #

spring.application.name=demo
spring.main.allow-bean-definition-overriding=true
spring.cloud.bootstrap.enabled=true
spring.main.cloud-platform=KUBERNETES

问题分析与修复方案 #

问题根源 #

错误本质是configMapPropertySourceLocator类型的Bean重复注册：

• 一个是Config Data模式下自动注册的configDataConfigMapPropertySourceLocator
• 另一个是Fabric8 Bootstrap配置类中定义的configMapPropertySourceLocator
  两者冲突导致自动装配时无法确定注入哪一个实例。

具体修复步骤 #

1. 清理重复配置
   删除application.properties中的以下重复配置项，这些配置只需要在bootstrap.properties中保留一份：

   spring.cloud.bootstrap.enabled=true
   spring.main.cloud-platform=KUBERNETES
   

2. 对齐Spring Cloud与Spring Boot版本
   Spring Boot 3.1.x对应的Spring Cloud版本必须是2022.0.x（Kilburn），版本不兼容会触发自动装配逻辑冲突。确保spring-cloud-dependencies的版本配置正确，例如：

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

3. 强制使用Bootstrap模式（可选）
   如果版本对齐后仍有问题，在bootstrap.properties中添加以下配置，禁用Config Data模式，避免额外的Bean注册：

   spring.cloud.kubernetes.config.use-config-data=false
   

4. 移除Bean覆盖配置
   建议删除spring.main.allow-bean-definition-overriding=true，该配置会掩盖潜在的Bean冲突问题，保持默认的严格模式更利于排查问题。

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