jenkins 中 java 11 不生效需依次确认：jdk 在 global tool configuration 中显式配置且 java_home 为绝对路径；流水线中用 tools 指定而非 withenv 或 export；maven/gradle 插件及源码兼容 java 11（如添加 javax.annotation-api、升级 lombok）；agent 进程环境变量（systemd/nssm 中显式设置 java_home）。
Java 11 在 Jenkins 中不生效？先确认 JDK 安装路径是否被 Jenkins 真正识别
Jenkins 不会自动扫描系统 PATH 或 /usr/lib/jvm 下的 JDK，必须显式声明。常见现象是：本地终端运行 java -version 显示 11，但 Jenkins 构建日志里仍是 java version "1.8.0_292"。
- 进 Jenkins 管理界面 → Global Tool Configuration → 找到 JDK 配置区 → 点击 Add JDK
-
Name建议填jdk-11.0.20（带版本号，避免和旧 JDK 混淆） -
JAVA_HOME必须填绝对路径，比如/opt/java/jdk-11.0.20；不能填/usr/bin/java或软链接路径（Jenkins 会解析失败） - 勾选 Install automatically 要谨慎：Jenkins 默认安装的是 OpenJDK 11.0.16（较老），若项目依赖新 API（如
String.stripIndent()），得手动上传或指定镜像源
流水线中指定 JDK 11 失败？tools 和 withEnv 的优先级有坑
在 Jenkinsfile 里写 tools { jdk 'jdk-11.0.20' } 是最稳妥的方式，但很多人误用 withEnv 或 shell 层面 export，结果被 Maven/Gradle 插件忽略。
-
tools会同时设置JAVA_HOME和把$JAVA_HOME/bin加入 PATH，且作用于整个steps块 - 不要在
sh步骤里单独export JAVA_HOME=...：Maven 3.9+ 默认读取JAVA_HOME，但 Gradle 7.6+ 优先看org.gradle.java.home配置项 - 若用 Maven，确保
pom.xml中maven-compiler-plugin的source和target设为11，否则编译器仍用默认 JDK 8 模式 - Gradle 项目需检查
gradle.properties是否硬编码了org.gradle.java.home=/usr/lib/jvm/java-8-openjdk—— 这个配置会覆盖 Jenkins 的tools设置
旧项目编译报错 “package javax.annotation does not exist”？Java 11 移除了 EE 模块
Java 9 开始模块化，Java 11 彻底移除 java.xml.ws、java.corba、java.transaction 和 javax.annotation 等 Java EE 相关包。这不是 Jenkins 配置问题，而是代码兼容性断层。
- Maven 项目需显式添加替代依赖，例如：
<dependency><br> <groupId>javax.annotation</groupId><br> <artifactId>javax.annotation-api</artifactId><br> <version>1.3.2</version><br></dependency>
- Spring Boot 2.1+ 已默认处理该迁移，但若用 Spring Boot 1.5 或纯 Spring MVC 项目，还需检查是否引用了
com.sun:tools（已被移除，需改用jdk.compiler模块） - 使用 Lombok 的项目要升级到 1.18.24+，旧版在 Java 11 下会因注解处理器路径问题导致编译失败
Jenkins Agent 启动脚本没加载新 JDK？Linux 系统服务环境隔离是隐形杀手
很多 Jenkins Agent 是通过 systemd 或 init.d 启动的，这类服务默认不读取用户 shell 的 .bashrc 或 .profile，所以即使你在 Agent 主机上配好了 JAVA_HOME，Jenkins 进程也看不到。
立即学习“Java免费学习笔记（深入）”；
- 查 Agent 进程真实环境：
ps aux | grep jenkins→ 找到启动命令 → 进入对应工作目录执行env | grep JAVA - systemd 方式部署的 Agent，需编辑
/etc/systemd/system/jenkins-agent.service，在[Service]段加：Environment="JAVA_HOME=/opt/java/jdk-11.0.20" - 重启服务后务必执行
systemctl daemon-reload && systemctl restart jenkins-agent，只 reload 不 restart 无效 - Windows Agent 若用 NSSM 安装，需在服务属性 → Environment 标签页手动添加
JAVA_HOME变量
Java 版本升级不是改个配置就完事——JDK 自身行为变化、构建工具链的隐式依赖、Agent 运行环境的隔离机制，三者叠加才构成真实障碍。最容易被跳过的，是检查 Agent 进程实际看到的环境变量，而不是相信“我明明在服务器上 echo $JAVA_HOME 是对的”。
