JAKS流水线部署Java11项目Maven编译报错问题排查

核心前提 #

本地命令行、STS IDE构建全部成功，仅JAKS流水线部署到K8s环节编译失败，说明pom文件本身无语法错误，问题完全来自流水线构建环境与本地环境的配置差异。

报错原因拆解 #

• Fatal error compiling: invalid target release: 11
  触发场景为pom配置java.version=11或maven.compiler.source/target=11时。直接原因是执行Maven编译命令的运行环境中，安装激活的JDK版本低于11。低版本JDK的编译器最高仅支持生成对应版本的字节码文件，比如JDK8最多支持target版本为1.8，无法生成11版本的目标字节码，直接抛出该错误。
• Fatal error compiling: invalid flag: --release
  触发场景为pom配置maven.compiler.release=11时。直接原因是执行Maven编译命令的运行环境中，安装激活的JDK版本低于9（绝大多数情况为JDK8）。--release是JDK9版本才新增的javac编译参数，用于一次性对齐源码版本、目标字节码版本、引导类路径版本，JDK8及更早版本的编译器无法识别该参数，直接抛出该错误。

当前配置存在的问题 #

你的pom配置逻辑本身符合Spring Boot项目规范，没有依赖冲突或配置错误，核心问题是未对齐流水线构建环境的JDK版本：

• 本地环境安装并激活了JDK11，因此无论使用哪种编译版本配置，都可以正常完成编译
• JAKS流水线默认使用的构建节点/构建镜像大概率预装的是JDK8，且构建步骤未指定JDK11环境变量，导致Maven运行时调用的是低版本JDK的编译器，和你pom里指定的Java 11编译目标不匹配
• 额外提醒：你当前使用的spring-boot-starter-parent 2.6.9-SNAPSHOT是快照版本，稳定性没有正式版有保障，生产环境建议替换为2.6.x系列的正式发布版本。

修复方案 #

按优先级选择以下任意一种即可解决问题：

• 修改JAKS流水线构建配置：指定构建阶段使用JDK11版本的官方构建镜像，在构建步骤中明确配置JAVA_HOME环境变量指向JDK11安装路径，保证执行mvn命令时调用的是JDK11的编译器。可以在构建脚本最前端加一行mvn -v命令验证，输出内容中Java version字段显示为11即配置正确。
• 如果流水线暂时无法升级JDK版本，就将项目编译目标降级为JDK8：把pom中所有Java版本相关配置（java.version、maven.compiler.source/maven.compiler.target、maven.compiler.release）的值全部改为8，你当前使用的Spring Boot 2.6.x、Spring Cloud 2021.0.3版本均兼容JDK8，可以正常运行。

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