已配置OpenJDK-17.0.5，Jenkins仍指向旧JDK问题排查

核心问题拆解 #

从日志输出可明确两个关键异常：

• 尽管JAVA_HOME已指向JDK 17路径，但java命令仍调用Docker容器默认的Java 11
• Maven提示JAVA_HOME配置错误

具体原因 #

1. JDK工具路径配置错误 #

日志中的JAVA_HOME为/var/jenkins_home/tools/hudson.model.JDK/openjdk-17.0.5/openjdk-17.0.5，对应的PATH路径是该目录下的bin。但正常情况下，JDK的bin目录应直接位于工具根目录下（即/var/jenkins_home/tools/hudson.model.JDK/openjdk-17.0.5/bin）。

这意味着PATH中添加的JDK 17路径下不存在java可执行文件，shell会自动跳过该路径，继续在后续PATH中查找，最终命中容器默认的/opt/java/openjdk/bin/java（Java 11）。

2. Maven报错的直接原因 #

Maven启动时会校验$JAVA_HOME/bin/java的有效性，由于当前JAVA_HOME多了一层重复的openjdk-17.0.5子目录，Maven无法找到有效的Java执行文件，因此抛出JAVA_HOME配置错误提示。

3. Shell哈希缓存的影响 #

即使后续修正PATH，shell的哈希表（hash）可能已缓存了之前找到的Java 11路径，导致which java和java -version仍指向旧版本。这是shell的优化机制，会缓存已找到命令的路径，避免重复遍历PATH。

验证与修复建议 #

• 检查JDK实际路径：在Jenkins节点执行ls -l /var/jenkins_home/tools/hudson.model.JDK/openjdk-17.0.5/，确认bin目录的位置。
• 修正JDK工具配置：在Jenkins「全局工具配置」中调整JDK的安装路径，确保JAVA_HOME指向包含bin目录的父级目录。
• 重置Shell哈希缓存：在流水线的shell脚本开头添加hash -r命令，强制shell重新遍历PATH查找命令。
• 关联Maven与JDK：确保Jenkins的Maven工具配置关联到目标JDK，或在流水线中明确指定Maven使用的JDK环境。

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