Spring Boot 2.7.18与spring-cloud-starter-kubernetes 1.1.10的configMapPropertySourceLocator异常排查

核心原因分析 #

你遇到的io.fabric8.kubernetes.api.builder.Function类缺失问题，本质是版本不兼容导致的依赖树混乱：

• Spring Boot 2.7.x对应的Spring Cloud版本是2021.0.x（代号Jubilee），而你使用的spring-cloud-starter-kubernetes:1.1.10.RELEASE属于Spring Cloud Hoxton版本（仅兼容Spring Boot 2.2.x~2.4.x），跨版本搭配会导致依赖传递异常。
• 即使强行保留1.1.10版本，该starter依赖的fabric8 kubernetes client版本也可能被Spring Boot 2.7.x的依赖覆盖或缺失必要组件。

优先解决方案：修正版本兼容性 #

直接升级spring-cloud-starter-kubernetes到与Spring Boot 2.7.x兼容的版本：
Spring Cloud 2021.0.x对应的spring-cloud-starter-kubernetes版本为3.1.x系列（例如3.1.6，可根据官方发布的最新兼容版本调整）。

Maven配置示例 #

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-kubernetes</artifactId>
    <version>3.1.6</version>
</dependency>

Gradle配置示例 #

implementation 'org.springframework.cloud:spring-cloud-starter-kubernetes:3.1.6'

修改后，starter会自动引入兼容的fabric8 kubernetes client版本，无需手动添加额外依赖，即可解决类缺失问题。

临时 workaround（不推荐）：保留旧版starter并补全依赖 #

如果因特殊原因必须使用spring-cloud-starter-kubernetes:1.1.10.RELEASE，需要显式引入其依赖的fabric8 kubernetes client版本：

1. 添加fabric8 kubernetes client依赖 #

spring-cloud-starter-kubernetes:1.1.10.RELEASE对应的兼容fabric8版本为4.13.0：

Maven

<dependency>
    <groupId>io.fabric8</groupId>
    <artifactId>kubernetes-client</artifactId>
    <version>4.13.0</version>
</dependency>

Gradle

implementation 'io.fabric8:kubernetes-client:4.13.0'

2. 排查并排除冲突依赖 #

使用依赖树命令检查是否有其他依赖引入了旧版fabric8组件：

• Maven：

  mvn dependency:tree | grep fabric8
  

• Gradle：

  ./gradlew dependencies | grep fabric8
  

若发现冲突版本，在对应依赖中排除：

<dependency>
    <groupId>冲突依赖的groupId</groupId>
    <artifactId>冲突依赖的artifactId</artifactId>
    <exclusions>
        <exclusion>
            <groupId>io.fabric8</groupId>
            <artifactId>kubernetes-client</artifactId>
        </exclusion>
    </exclusions>
</dependency>

验证 #

修改依赖后，重新构建并启动应用，configMapPropertySourceLocator Bean初始化失败的问题应能解决。

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