Jenkins 2.107.2：配置自定义JDK+Maven构建报错求助

遇到Maven找不到指定JDK的问题挺常见的，结合你用的Jenkins版本，咱们一步步排查解决：

1. 先确认全局工具配置的JDK是否有效 #

进入Jenkins首页 → 系统管理 → 全局工具配置，检查你添加的JDK：

• 确保JDK的名称和你在Maven项目里选择的完全一致（大小写敏感，比如JDK1.8不能写成jdk1.8）
• 如果是手动指定JDK路径，要验证Jenkins用户（通常是jenkins）能访问该路径：
  登录Jenkins服务器，执行su jenkins后，运行ls /你的JDK路径/bin/java，确保文件存在且可执行
• 如果是自动安装的JDK，去系统管理 → 系统日志里查看有没有安装失败的报错，比如网络问题导致下载中断

2. 检查Maven项目的配置关联 #

打开你的Maven项目配置页：

• 找到JDK选项（如果没看到，确认JDK Plugin已安装，Jenkins 2.107.2默认自带），选择你配置的目标JDK，不要选(Default)
• 在构建部分，确认Maven版本是你全局配置的maven-3.5.3
• 额外检查项目的pom.xml：如果maven-compiler-plugin指定了source/target版本，要和你选的JDK版本匹配（比如JDK1.8对应1.8），避免版本冲突导致的隐性报错

3. 强制Maven使用指定JDK（关键修复） #

有时候Jenkins的JDK配置不会自动传递给Maven，这时候可以在构建命令里强制指定：
在项目的构建 → Goals and options中添加参数：

-Djava.home=/var/jenkins_home/tools/hudson.model.JDK/你的JDK名称/jre

比如你的JDK名称是JDK1.8，路径就是/var/jenkins_home/tools/hudson.model.JDK/JDK1.8/jre

或者更直接指定编译工具路径：

-Dmaven.compiler.executable=/var/jenkins_home/tools/hudson.model.JDK/JDK1.8/bin/javac -Dmaven.compiler.java.home=/var/jenkins_home/tools/hudson.model.JDK/JDK1.8

4. 排查环境变量与权限问题 #

• 进入系统管理 → 系统设置，检查全局属性里是否设置了JAVA_HOME，如果有，建议删除这个全局配置，让每个项目独立指定JDK，避免覆盖
• 验证Jenkins用户的环境：登录服务器执行su jenkins，然后运行echo $JAVA_HOME和java -version，如果输出的是系统默认JDK，那可能是Jenkins启动脚本加载了系统环境变量，修改/etc/default/jenkins（Linux）去掉里面的JAVA_HOME配置即可

5. 验证环境配置是否生效 #

在项目里添加一个构建步骤 → Execute shell，执行以下命令：

echo $JAVA_HOME
which java
java -version
mvn -v

运行一次构建，查看输出，确认JAVA_HOME指向你配置的JDK，且java -version和mvn -v显示的JDK版本一致

特殊情况：Maven自身配置冲突 #

如果报错明确指向Maven的安装路径，检查Maven的settings.xml：
路径是/var/jenkins_home/tools/hudson.tasks.Maven_MavenInstallation/maven-3.5.3/conf/settings.xml
搜索<java.home>，如果有配置，删除或者修改为你的目标JDK路径

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