如何让Jenkins声明式流水线指定阶段不使用全局编译工具？

在声明式流水线中，全局tools块会为整个流水线绑定指定版本的Maven和JDK，但如果需要让某个阶段跳过这些全局配置，直接使用节点上默认的编译工具，可通过以下两种方式实现：

方法1：重置环境变量覆盖全局工具配置 #

全局tools的本质是修改PATH、JAVA_HOME、MAVEN_HOME等环境变量，指向Jenkins配置的工具安装路径。我们可以在目标阶段中重置这些变量，让系统使用默认路径下的工具：

pipeline {
    agent {
        label "node-1"
    }
    tools {
        maven 'maven3.6.2'
        jdk 'jdk-17-linux'
    }
    stages {
        stage('使用全局配置构建') {
            steps {
                sh 'mvn -v' // 输出maven3.6.2版本
                sh 'java -version' // 输出jdk17版本
            }
        }
        stage('使用默认工具构建') {
            environment {
                // 重置为系统默认PATH，移除全局tools追加的路径
                PATH = '/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'
                // 清空全局配置的工具环境变量
                JAVA_HOME = ''
                MAVEN_HOME = ''
            }
            steps {
                sh 'mvn -v' // 输出节点默认maven版本
                sh 'java -version' // 输出节点默认jdk版本
            }
        }
    }
}

方法2：重新指定Agent隔离环境 #

如果允许阶段重新初始化执行环境，可以在目标阶段单独指定agent且不配置tools，这样该阶段会直接使用节点上的默认工具：

pipeline {
    agent {
        label "node-1"
    }
    tools {
        maven 'maven3.6.2'
        jdk 'jdk-17-linux'
    }
    stages {
        stage('使用全局配置构建') {
            steps {
                sh 'mvn -v'
                sh 'java -version'
            }
        }
        stage('使用默认工具构建') {
            agent {
                label "node-1" // 复用同一节点，但重新初始化环境
            }
            // 该阶段不配置tools，自动使用节点默认工具
            steps {
                sh 'mvn -v'
                sh 'java -version'
            }
        }
    }
}

注意事项 #

• 方法1无需重新创建agent环境，执行效率更高，适合在同一环境内快速切换工具。
• 方法2会重新初始化agent环境，隔离性更强，但会增加额外的初始化开销。
• 如果节点默认工具的路径不在标准PATH中，需要在environment块手动添加对应路径。

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