Jenkins无法覆盖PATH环境变量 无法切换使用Maven 3.8.2版本

问题原因 #

1. MAVEN_HOME未被覆盖：你现有的Pipeline脚本仅通过withEnv修改了PATH变量，没有重新赋值MAVEN_HOME，全局配置的旧版本MAVEN_HOME会持续生效。自由风格项目中单独执行的export命令作用域仅对同一段shell脚本生效，如果和mvn命令分在不同的执行块就会失效。
2. PATH优先级逻辑错误：
   • Pipeline中PATH+MAVEN的写法仅在Groovy层面将新Maven路径放到PATH最前端，执行sh步骤时会重新加载节点的全局环境变量，你之前配置的全局PATH+EXTRA规则会把旧版本Maven的路径插入到更靠前的位置，导致系统优先匹配到旧版本的mvn命令
   • 自由风格项目中你写的export PATH=$PATH:$MAVEN_HOME/bin是把新路径追加到PATH末尾，系统查找可执行文件时是从前往后匹配，自然会先找到旧版本的mvn
3. 这不是Jenkins的bug，属于环境变量加载顺序和作用域的配置问题。

解决方案 #

单个Pipeline适配写法 #

直接在withEnv中同时覆盖MAVEN_HOME和PATH，强制将新Maven的bin路径放在PATH最开头，避免被全局配置插队：

def maven_version = 'maven_3.8.2'
pipeline {
    agent any
    stages {
        stage ('build') {
            steps {
                script {
                    def mavenPath = tool maven_version
                    withEnv([
                        "MAVEN_HOME=${mavenPath}",
                        "PATH=${mavenPath}/bin:${env.PATH}"
                    ]) {
                        echo "PATH is: $PATH"
                        echo env.PATH
                        echo env.MAVEN_HOME
                        sh 'env'
                        sh 'mvn --version'
                    }
                }
            }
        }
    }
}

自由风格项目适配写法 #

将环境变量声明和mvn命令放在同一段shell执行块中，且把新Maven路径放在PATH最前面：

export MAVEN_HOME=/var/home/tools/hudson.tasks.Maven_MavenInstallation/maven_3.8.2
export PATH=$MAVEN_HOME/bin:$PATH
mvn --version

全局统一升级方案 #

直接修改全局配置即可让所有任务默认使用Maven 3.8.2，不需要修改每个任务的脚本：

1. 进入Manage Jenkins -> Configure System -> Global Properties -> Environment variables
2. 将MAVEN_HOME的值修改为Maven 3.8.2的路径，PATH+EXTRA配置不需要改动，会自动读取新的MAVEN_HOME生成对应路径

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