Spring Boot构建K8s Operator遇依赖版本冲突问题求助

问题本质 #

你碰到的io.fabric8.kubernetes.client.okhttp.OkHttpClientImpl重写StandardHttpClient的final方法close()错误，是fabric8 Kubernetes Client与项目中OkHttp版本不兼容导致的冲突。

错误原因 #

• OkHttp的StandardHttpClient类中，close()方法被标记为final，子类不允许重写该方法
• 你的项目里引入的fabric8版本，其OkHttpClientImpl类试图重写这个final方法，说明fabric8版本和当前依赖的OkHttp版本不匹配，类定义出现矛盾

解决步骤 #

1. 统一依赖版本（核心方案） #

fabric8 Kubernetes Client和Spring Boot版本有严格的兼容关系，必须对应：

• Spring Boot 3.x → fabric8 Kubernetes Client 6.x
• Spring Boot 2.x → fabric8 Kubernetes Client 5.x

Maven配置示例（Spring Boot 3.x + fabric8 6.x）

<properties>
    <spring-boot.version>3.2.0</spring-boot.version>
    <fabric8.kubernetes-client.version>6.10.0</fabric8.kubernetes-client.version>
</properties>

<dependencyManagement>
    <dependencies>
        <!-- 引入Spring Boot版本BOM -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>${spring-boot.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <!-- 引入fabric8版本BOM，确保所有组件版本统一 -->
        <dependency>
            <groupId>io.fabric8</groupId>
            <artifactId>kubernetes-client-bom</artifactId>
            <version>${fabric8.kubernetes-client.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>
    <!-- fabric8 Operator核心依赖 -->
    <dependency>
        <groupId>io.fabric8</groupId>
        <artifactId>kubernetes-operator</artifactId>
    </dependency>
    <!-- CRD生成工具，仅编译期需要 -->
    <dependency>
        <groupId>io.fabric8</groupId>
        <artifactId>crd-generator-apt</artifactId>
        <scope>provided</scope>
    </dependency>
</dependencies>

2. 手动排除冲突依赖 #

如果用BOM管理后仍存在版本冲突，直接排除Spring Boot或其他依赖中引入的旧版OkHttp：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <exclusions>
        <exclusion>
            <groupId>com.squareup.okhttp3</groupId>
            <artifactId>okhttp</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 验证依赖树 #

用命令确认OkHttp版本与fabric8要求一致：

• Maven：mvn dependency:tree | grep okhttp
• Gradle：./gradlew dependencies | grep okhttp

确保输出的OkHttp版本是fabric8对应版本依赖的版本（比如fabric8 6.x依赖OkHttp 4.x系列）

额外提醒 #

• 所有fabric8组件版本必须统一（比如kubernetes-client和kubernetes-operator不能用不同版本）
• CRD生成工具crd-generator-apt的版本必须和kubernetes-client版本完全匹配

内容的提问来源于stack exchange，提问作者Marin Sušić