Jenkins在macOS节点构建失败 手动执行及Windows节点正常

最近遇到一个挺棘手的Jenkins构建问题，跟你分享下排查思路和解决方案：

问题现象 #

• Jenkins使用macOS节点（mac_mini）构建时，执行git fetch命令直接失败，报错仓库找不到：remote: Not Found、fatal: repository 'http://gitlab.***.com/iOS-Team/iOSProject.git/' not found
• 手动登录这台macOS服务器，运行完全相同的git fetch命令却一切正常
• 把构建节点切换到Windows服务器后，构建又能顺利完成，说明Git仓库地址和项目本身配置没有问题

核心原因推测 #

这种「本地手动正常、Jenkins执行异常，换节点又恢复」的情况，基本可以锁定是Jenkins在macOS节点上的执行上下文和你手动操作的上下文不一致——大概率是凭证、权限或者代理配置的差异导致的。

一步步排查解决 #

1. 核对Jenkins的Git凭证
   先检查Jenkins里配置的Git访问凭证（不管是全局凭证还是项目专属凭证），是不是和你手动登录服务器时用的账号/token一致？有时候Jenkins节点用的是系统服务账户，和你登录的用户不是同一个，凭证存储的位置或者权限不一样，就会导致访问仓库被拒。建议重新配置一遍凭证，确保这个凭证拥有GitLab仓库的读取权限。

2. 检查节点的网络代理
   手动执行正常不代表Jenkins服务的网络配置相同。Jenkins在macOS上作为服务运行时，可能继承了系统的代理设置，或者自身配置了HTTP代理，而你手动登录时没有使用代理，导致访问GitLab失败。可以去Jenkins的「节点管理」里找到mac_mini节点，查看是否设置了特殊的环境变量（比如HTTP_PROXY），临时去掉代理再试一次构建。

3. 对比Git客户端版本
   不同版本的Git客户端处理HTTP请求的逻辑可能存在差异。看看Jenkins日志里的git --version输出，和你手动执行git --version的结果是否一致？如果版本差距较大，把macOS节点上的Git升级到和手动环境一致的版本试试。

4. 检查Jenkins运行用户的权限
   用ps aux | grep jenkins命令查看Jenkins在macOS上是用哪个用户运行的，然后检查这个用户的~/.gitconfig文件有没有异常，或者是否具备读取Git凭证的权限。甚至可以临时把Jenkins服务的运行用户换成你手动登录的那个用户，测试下能不能正常构建。

5. 清理Workspace缓存
   有时候Workspace里的旧Git缓存文件会引发问题。可以在Jenkins项目设置里勾选「构建前删除Workspace」，或者手动删掉macOS节点上的/Users/jenkins/jenkins/workspace/workspace/BPC_iOS_Release目录，然后重新触发构建。

关键错误日志参考 #

ERROR: Error fetching remote repo 'origin'
hudson.plugins.git.GitException: Failed to fetch from http://gitlab.***.com/iOS-Team/iOSProject.git
...
Caused by: hudson.plugins.git.GitException: Command "git fetch --tags --progress http://gitlab.***.com/iOS-Team/iOSProject.git +refs/heads/*:refs/remotes/origin/* --depth=1" returned status code 128:
stdout:
stderr: remote: Not Found
fatal: repository 'http://gitlab.***.com/iOS-Team/iOSProject.git/' not found

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