Kind集群中Java应用用kubernetes-client库遇类找不到问题求助

java.lang.NoClassDefFoundError 找不到 io.kubernetes.client.util.Config 类，核心原因是运行时环境缺少该类所在的依赖包，本地运行正常但集群部署失败，通常和构建产物或镜像打包流程有关，以下是具体排查和解决步骤：

1. 检查Maven依赖配置 #

确认 io.kubernetes.client-java 的依赖 scope 为默认的 compile（而非 provided），provided 标记的依赖不会被打包到最终产物中：

<dependency>
    <groupId>io.kubernetes</groupId>
    <artifactId>client-java</artifactId>
    <version>你的版本号</version>
    <!-- 不要设置为provided -->
</dependency>

2. 构建包含所有依赖的Fat Jar #

本地运行时IDE会自动加载依赖，但部署到集群时需要把所有依赖打包到同一个Jar里（即Fat Jar/Uber Jar），推荐使用 maven-shade-plugin 配置打包：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.4.1</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <!-- 替换成你的主类全路径 -->
                                <mainClass>com.your.package.YourMainApplication</mainClass>
                            </transformer>
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

3. 验证构建产物 #

执行 mvn package 后，在 target 目录下找到带 -jar-with-dependencies 后缀的Jar包，用以下命令检查缺失类是否存在：

jar tf target/your-app-jar-with-dependencies.jar | grep io/kubernetes/client/util/Config.class

如果输出该类的路径，说明打包成功；否则重新检查Maven配置。

4. 修正Dockerfile #

确保Dockerfile中复制的是上述Fat Jar，而非仅包含自身代码的Jar：

# 使用包含JRE的基础镜像
FROM openjdk:17-jdk-slim
WORKDIR /app
# 复制带依赖的Fat Jar
COPY target/your-app-jar-with-dependencies.jar app.jar
# 启动命令
ENTRYPOINT ["java", "-jar", "app.jar"]

如果用多阶段构建，注意复制正确的Jar包：

FROM maven:3.8.6-openjdk-17 AS build
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn package

FROM openjdk:17-jdk-slim
WORKDIR /app
# 复制带依赖的Jar
COPY --from=build /app/target/your-app-jar-with-dependencies.jar app.jar
ENTRYPOINT ["java", "-jar", "app.jar"]

5. 重新构建并部署 #

执行镜像构建命令（比如 docker build -t your-app:v1 .），然后重新部署到Kind集群，此时Pod应该能正常启动，之后再验证ServiceAccount的K8s API认证逻辑。

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