Maven构建Spring Boot应用失败求助（附POM及错误日志）

以下是针对这类问题的核心排查步骤，结合你的pom.xml配置和错误日志逐一验证：

• 检查插件核心配置
  确保pom.xml中maven-kubernetes-plugin的关键配置项无误：

  • 确认kubernetesManifest指向的YAML文件路径正确，比如是否存在src/main/kubernetes目录及对应的部署文件
  • 镜像构建部分要匹配Spring Boot版本，比如使用JDK17的应用，基础镜像选openjdk:17-jre-slim，示例配置：

    <plugin>
      <groupId>io.fabric8</groupId>
      <artifactId>maven-kubernetes-plugin</artifactId>
      <version>6.7.0</version> <!-- 适配Spring Boot 3.x的版本 -->
      <configuration>
        <kubernetesManifest>src/main/kubernetes/deployment.yaml</kubernetesManifest>
        <images>
          <image>
            <name>your-registry/your-app:${project.version}</name>
            <build>
              <from>openjdk:17-jre-slim</from>
              <assembly>
                <descriptorRef>spring-boot</descriptorRef>
              </assembly>
            </build>
          </image>
        </images>
      </configuration>
    </plugin>
    

• 验证集群连接有效性

  • 本地执行kubectl config current-context确认当前集群上下文正确，插件默认复用kubectl的配置
  • 如果集群需要额外认证，检查是否设置了KUBECONFIG环境变量，或在pom中配置authConfig参数指定认证文件

• 定位错误日志中的核心问题
  从错误日志里抓关键报错信息：

  • 若提示镜像拉取失败：确认镜像已推送到集群可访问的镜像仓库，仓库地址、镜像名和版本是否和配置一致
  • 若提示资源创建失败：检查Kubernetes YAML中的字段合法性，比如Deployment的containerPort是否和Spring Boot应用端口匹配，Service的selector是否和Pod标签对应
  • 若提示Maven依赖冲突：确保插件版本和Spring Boot版本兼容，比如Spring Boot 2.x用插件5.x，Spring Boot 3.x用插件6.x

• 分步执行命令缩小范围
  不要直接跑完整命令，分步执行定位问题阶段：

  1. 执行mvn clean package确认Spring Boot应用能正常打包
  2. 执行mvn k8s:build确认镜像能正常构建
  3. 执行mvn k8s:deploy确认部署到集群的环节是否出错

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