Jenkins Pipeline执行Gradle命令报错：'gradle'未被识别

我之前也碰到过一模一样的问题——Windows代理机器上直接跑Gradle完全正常，但放到Pipeline里就报'gradle' is not recognized as an internal or external command，核心原因是Jenkins Pipeline的环境变量没有正确包含Gradle的可执行路径，哪怕你全局配置了GRADLE_HOME也没用。下面给你几个靠谱的解决办法：

1. 手动在Pipeline中补充PATH环境变量 #

Windows下Gradle的可执行文件在%GRADLE_HOME%\bin目录，你需要把这个路径加到Pipeline的PATH里，确保系统能找到gradle命令。修改你的Pipeline脚本如下：

node('windows_slave') {
    stage('API') {
        // 先把Gradle的bin目录追加到PATH开头
        env.PATH = "${env.GRADLE_HOME}\\bin;${env.PATH}"
        
        // 你的Git checkout代码
        git checkout([$class: 'GitSCM', branch: [[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[url: '你的仓库地址']]])
        
        // 执行Gradle命令
        bat 'gradle build'
    }
}

注意Windows的路径分隔符是反斜杠\\，环境变量用分号;分隔，别写成Linux的冒号了。

2. 使用Jenkins官方Gradle插件（更推荐） #

直接调用bat 'gradle'容易踩环境变量的坑，用Jenkins的Gradle插件能自动处理环境配置，稳定性更高：

• 先在Jenkins插件管理里安装Gradle Plugin
• 然后修改Pipeline脚本，用插件提供的gradle步骤：

node('windows_slave') {
    stage('API') {
        git checkout([$class: 'GitSCM', branch: [[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[url: '你的仓库地址']]])
        
        // 用Gradle插件执行构建
        gradle(
            tasks: 'build',
            wrapper: false, // 如果你的项目根目录有gradlew脚本，可以改成true
            useWrapper: false
        )
    }
}

插件会自动读取你全局配置的GRADLE_HOME，不用手动处理PATH。

3. 检查Windows代理节点的环境变量配置 #

有时候全局配置的GRADLE_HOME没有正确传递到代理节点，你需要确认：

• 进入Jenkins -> 管理Jenkins -> 节点 -> 找到你的windows_slave -> 配置
• 找到「节点属性」里的「环境变量」，确保已经添加了GRADLE_HOME（值是你的Gradle安装路径，比如C:\gradle-7.5），并且PATH变量里追加了%GRADLE_HOME%\bin

4. 先验证代理机器本地的Gradle是否正常 #

登录到Windows代理机器，打开CMD，输入gradle -v，如果这个命令都报错，那就是本地Gradle安装或者系统环境变量的问题，先把本地的问题解决了再看Jenkins的配置。

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