Jenkins流水线配置jdk17后JAVA_HOME路径无效的问题求助

问题根源 #

你在流水线里同时用了tools块和手动设置JAVA_HOME，这会造成冲突。tools { jdk 'jdk17' }已经会自动把正确的JDK路径注入到环境变量的JAVA_HOME中，而手动调用${tool 'jdk17'}返回的路径多了多余后缀/abc，覆盖了正确路径。

解决方案 #

步骤1：移除手动设置的JAVA_HOME #

修改流水线代码，删掉environment块里手动赋值的JAVA_HOME，让tools块自动管理该变量：

pipeline {
    agent any
    tools {
        jdk 'jdk17'
    }
    stages {
        stage('git clone') {
            steps {
                git branch: 'backend/taskmaster/deploy', credentialsId: 'HJ', url: 'https://lab.ssafy.com/s10-webmobile2-sub2/S10P12A305.git'
            }
        }
        stage('create bootjar'){
            steps{
                echo "JAVA_HOME=${env.JAVA_HOME}"
                sh '''
                    cd taskmaster
                    chmod +x gradlew
                    ./gradlew clean bootJar
                '''
            }
        }
    }
}

步骤2：验证JDK实际安装路径（若步骤1无效） #

如果修改后仍报错，登录Jenkins服务器检查JDK安装目录：

• 进入/var/jenkins_home/tools/hudson.model.JDK/jdk17目录，查看内部结构
• 如果JDK实际根目录是该路径下的子文件夹（比如jdk17/jdk-17.0.8），需要在Jenkins管理后台的全局工具配置中，找到名为jdk17的JDK配置，把"JAVA_HOME"字段修改为正确的子目录路径（比如/var/jenkins_home/tools/hudson.model.JDK/jdk17/jdk-17.0.8）

原理说明 #

Jenkins的tools块会自动处理JDK路径注入：

• 声明jdk 'jdk17'后，Jenkins会将该JDK的配置路径设为当前流水线的JAVA_HOME环境变量
• 手动调用${tool 'jdk17'}一般用于获取工具安装路径，但对JDK来说，tools块已经完成了环境变量配置，重复设置会导致路径错误

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