Jenkins Pipeline调用Gradle失败：已配置插件仍提示gradle未找到

这问题我帮不少开发者排查过，核心原因是你虽然在全局工具配置里设了Gradle自动安装，但Jenkins Pipeline默认不会自动把Gradle的路径注入到构建环境的PATH变量里。下面是几种靠谱的解决办法，按推荐程度排序：

1. 使用Gradle插件提供的gradle步骤（最推荐） #

Jenkins的Gradle插件专门提供了标准化的步骤来执行Gradle命令，能自动处理环境变量和路径问题，不用你手动折腾。示例Jenkinsfile如下：

pipeline {
    agent any
    tools {
        gradle '你的Gradle工具名称' // 这里填你在「Global Tools Configuration」里设置的Gradle名称，大小写敏感！
    }
    stages {
        stage('Build Project') {
            steps {
                gradle 'clean build' // 直接用插件的gradle步骤，自动识别路径
            }
        }
    }
}

添加tools块后，Jenkins会自动把你配置的Gradle安装路径加到当前构建的PATH中，不管是用插件的gradle步骤，还是后续执行shell命令，都能正常识别gradle命令了。

2. 若需用Shell命令执行gradle #

如果你的场景必须用sh或bat命令执行Gradle，确保先通过tools块注入环境变量即可：

pipeline {
    agent any
    tools {
        gradle '你的Gradle工具名称'
    }
    stages {
        stage('Check Gradle Path') {
            steps {
                sh 'which gradle' // 现在就能正常输出Gradle的安装路径了
                sh 'gradle --version'
            }
        }
    }
}

要是你用的是脚本式Pipeline，也可以手动获取Gradle的安装路径：

node {
    def gradleHome = tool name: '你的Gradle工具名称', type: 'gradle'
    sh "${gradleHome}/bin/gradle clean build"
}

3. 排查常见坑点 #

• 名称匹配问题：一定要确保tools块里写的Gradle名称和「Global Tools Configuration」里的名称完全一致，Jenkins对这个是大小写敏感的，别因为少写个大写字母踩坑。
• 代理节点权限：如果用了分布式构建，要确认执行构建的代理节点能正常下载Gradle安装包（自动安装需要节点有网络访问权限）。
• 插件版本问题：如果是比较老的Jenkins版本，建议把Gradle插件更新到最新版，避免兼容性导致的环境变量注入失败。

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