Jenkins无法找到有效Java安装的问题排查求助

问题背景 #

使用jenkins-2.387.3版本，已按官方要求手动解压JRE11，但Jenkins仍无法找到有效Java安装，需明确排查方法。

本地Java版本信息 #

java -version
openjdk version "11.0.18" 2023-01-17
OpenJDK Runtime Environment BiSheng_JDK_Enterprise_2.3.0.360.B001 (build 11.0.18+10)
OpenJDK 64-Bit Server VM BiSheng_JDK_Enterprise_2.3.0.360.B001 (build 11.0.18+10, mixed mode)

日志报错内容 #

jenkins[9063]: jenkins: failed to find a valid Java installation
systemd[1]: jenkins.service: Main process exited, code=exited, status=1/FAILURE
systemd[1]: jenkins.service: Failed with result 'exit-code'.
systemd[1]: Failed to start My Company Jenkins Controller.

Jenkins服务状态 #

● jenkins.service - My Company Jenkins Controller
   Loaded: loaded (/usr/lib/systemd/system/jenkins.service; disabled; vendor preset: disabled)
  Drop-In: /etc/systemd/system/jenkins.service.d
           └─override.conf
   Active: failed (Result: exit-code) since Wed 2023-05-17 21:28:51 CST; 5min ago
  Process: 11759 ExecStart=/usr/bin/jenkins (code=exited, status=1/FAILURE)
 Main PID: 11759 (code=exited, status=1/FAILURE)

已配置的systemd服务文件 #

通过systemctl edit jenkins.service编辑的内容：

[Unit]
Description=My Company Jenkins Controller

[Service]
# Add JVM configuration options
Environment="JAVA_HOME=/root/jre-11.0.18"
Environment="JAVA_OPTS=-Djava.awt.headless=true"

排查步骤 #

1. 修复JAVA_HOME路径权限问题 #

Jenkins默认以jenkins用户运行，你设置的/root/jre-11.0.18属于root私有目录，普通用户无访问权限。

• 检查目录权限：

  ls -ld /root/jre-11.0.18
  

• 若权限为drwx------，将JRE移动到公共目录并修改权限：

  mv /root/jre-11.0.18 /usr/local/
  chown -R jenkins:jenkins /usr/local/jre-11.0.18
  chmod -R 755 /usr/local/jre-11.0.18
  

• 更新systemd配置中的JAVA_HOME为/usr/local/jre-11.0.18

2. 验证Jenkins用户能否访问Java执行文件 #

切换到jenkins用户，手动执行Java命令验证：

su - jenkins -c "/usr/local/jre-11.0.18/bin/java -version"

若报错，说明路径或权限仍有问题，需重新调整。

3. 确保systemd配置生效 #

修改配置后，必须重新加载配置并重启服务：

systemctl daemon-reload
systemctl restart jenkins.service

验证环境变量是否加载成功：

systemctl show jenkins.service --property=Environment

输出需包含JAVA_HOME=/usr/local/jre-11.0.18

4. 确认Jenkins启动脚本的Java查找逻辑 #

Jenkins启动脚本/usr/bin/jenkins的查找顺序为：

• 优先读取JAVA_HOME/bin/java
• 其次检查系统PATH中的java可执行文件
• 最后尝试/usr/lib/jvm/下的默认路径

若脚本中存在硬编码的Java路径，打开/usr/bin/jenkins找到类似JAVA=的行，注释掉该行或修改为你的JRE路径。

5. 验证JRE完整性 #

确保解压后的JRE包含bin/java、lib等核心目录，无文件缺失。

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