Jenkins执行Gradle buildProduction任务失败 手动运行成功

这个问题和项目代码、Gradle wrapper本身无关，核心是Jenkins执行构建时的运行上下文，和你手动登录服务器在工作目录执行命令的上下文不一致。报错里显示构建时只搜索了Gradle Central Plugin Repository，说明完全没加载到你本地配置的其他插件仓库源，常见触发点有四类：

• 运行用户差异：手动执行命令用的是当前登录的系统用户，该用户家目录下~/.gradle/gradle.properties里配置了可正常访问的插件仓库镜像、代理、私服认证信息，之前拉取的插件缓存也存在这个用户的目录下；而Jenkins服务默认用独立的jenkins系统用户运行任务，该用户家目录下没有对应的Gradle配置，默认只会请求Gradle官方中央插件仓库，要么网络不通，要么没有私服权限，就会报插件找不到的错误。
• Gradle用户目录被覆盖：Jenkins的Gradle插件如果配置了独立的GRADLE_USER_HOME路径，会指向一个没有任何自定义配置、没有缓存的空目录，构建时读不到本地验证过的仓库配置。
• 全局配置强制覆盖项目仓库：Jenkins全局Gradle配置如果开启了“强制使用全局仓库替换项目定义仓库”的选项，会直接忽略项目本身的插件仓库配置，默认只从官方插件库拉取资源。
• 代理配置缺失：手动执行时当前用户的环境变量里配置了可访问外网的代理，Jenkins服务进程没有加载对应的代理环境变量，连接官方仓库失败被判定为插件不存在。

按从简单到复杂的顺序操作即可：

1. 确认构建命令调用的是项目自带的wrapper：不要用Jenkins Gradle插件里绑定的全局Gradle版本执行任务，直接添加Shell/批处理构建步骤，显式执行项目下的gradlew脚本。Linux环境执行命令前先打印Gradle用户目录确认路径：

   echo $GRADLE_USER_HOME
   ./gradlew buildProduction
   

   如果打印出的GRADLE_USER_HOME和手动执行时同命令输出的路径不一致，直接在构建命令前加export指定正确路径，比如手动执行时用户的Gradle目录是/root/.gradle，就加一行export GRADLE_USER_HOME=/root/.gradle，提前给jenkins用户配置该目录的读权限即可。
2. 给jenkins用户配置独立的Gradle全局配置：找到jenkins用户的家目录（Linux下默认是/var/lib/jenkins），在下面新建.gradle文件夹，把能正常构建的用户目录下的gradle.properties复制进去，把文件所有者改成jenkins用户，保证配置里的仓库地址、代理、认证信息都能被正常读取。
3. 关闭Jenkins全局Gradle的仓库覆盖配置：进入Jenkins系统管理-全局工具配置-Gradle配置项，取消所有类似“强制替换项目仓库”“使用全局镜像源”的勾选，不要干预项目本身的仓库配置逻辑。
4. 兜底配置（最稳妥，不依赖环境差异）：直接在项目根目录的settings.gradle里显式声明pluginManagement仓库规则，把能正常拉取插件的仓库地址写死在项目配置里，不管哪个用户、什么环境执行构建，都会按配置的地址找插件，示例：

   pluginManagement {
       repositories {
           // 替换成实际能正常访问的插件仓库，比如内部私服、国内镜像
           maven { url 'https://你的私有插件仓库地址' }
           gradlePluginPortal()
           mavenCentral()
       }
   }
   

   配置提交到Git仓库之后，不管是本地执行还是Jenkins执行，都不会因为全局配置缺失出现插件找不到的问题。

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