Jenkins Docker代理指定JDK21.0.2生效异常求助

以下是可能导致此问题的原因及对应解决方法：

• Shell命令缓存问题
  即使PATH已指向JDK21，shell可能缓存了旧的java命令路径。可以直接调用JDK21的完整二进制路径验证：

  /path/to/jdk-21.0.2/bin/java -version
  

  如果结果显示21版本，执行hash -r清除shell命令缓存后，再重新运行java -version即可。

• Docker容器环境变量优先级冲突
  若代理容器的Dockerfile或启动命令中通过ENV硬编码了JAVA_HOME或PATH（比如ENV JAVA_HOME=/opt/temurin-17），这些全局环境变量会覆盖Jenkins Tools注入的配置。
  解决方法：要么修改Dockerfile移除硬编码的Java环境变量，要么在Pipeline中显式强制覆盖：

  pipeline {
      agent any
      tools {
          jdk 'jdk-21.0.2'
      }
      stages {
          stage('Check Java Version') {
              steps {
                  script {
                      env.JAVA_HOME = tool 'jdk-21.0.2'
                      env.PATH = "${env.JAVA_HOME}/bin:${env.PATH}"
                      sh 'java -version'
                  }
              }
          }
      }
  }
  

• 代理容器shell启动脚本重置环境变量
  容器内的shell启动脚本（如.bashrc、.profile）若存在重置JAVA_HOME或PATH的代码，会覆盖Jenkins注入的变量。检查并注释掉这些脚本中相关的环境变量配置即可。

• Jenkins工具配置路径无效
  确认Manage Jenkins->Tools中配置的jdk-21.0.2路径在Docker代理容器内真实存在，且Jenkins代理用户有执行权限。可在Pipeline中打印工具路径验证：

  sh 'echo $(tool \'jdk-21.0.2\')'
  

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