配置Jenkins跟踪网络Git仓库遇到连接失败问题

我之前也踩过一模一样的坑！用UNC路径（\\host\path\to\repo）配置Jenkins Git仓库时出现git.exe ls-remote异常，大多是权限、路径格式或Git配置的问题，给你几个实用的排查方向：

1. 检查Jenkins服务的运行账号权限 #

Jenkins默认用Local System账号运行，这个账号没有访问网络共享目录的权限，这是最常见的诱因。解决步骤：

• 打开Windows服务管理器（services.msc），找到Jenkins服务
• 右键点击「属性」→「登录」标签页，切换到「此账户」，输入一个有权限访问\\host\path\to\repo的域账号或本地账号（一定要先手动验证这个账号能打开共享目录）
• 输入账号密码后重启Jenkins服务，再尝试配置Git仓库

2. 调整Git仓库的路径格式 #

Git在Windows下对UNC路径的支持偶尔会有兼容性问题，试试这两种替代格式：

• 把反斜杠改成正斜杠：//host/path/to/repo
• 或者将共享目录映射为网络驱动器（比如Z盘），用Z:\to\repo作为仓库URL——注意：这个映射必须在Jenkins服务运行的账号下创建，可以用runas /user:目标账号 cmd打开命令行，再执行net use Z: \\host\path完成映射

3. 手动测试Git命令定位问题 #

在Jenkins服务器上，用Jenkins运行的账号打开命令提示符，执行：

git.exe ls-remote -h \\host\path\to\repo HEAD

• 如果手动执行也报错：说明是Git客户端或共享权限的问题——更新Git到最新版本（旧版本对UNC路径支持差），同时检查共享目录是否给该账号开放了读取权限
• 如果手动执行成功：说明是Jenkins配置问题，检查全局工具配置里的Git路径是否正确，或者确认Jenkins服务确实切换到了指定账号

4. 排查网络和防火墙问题 #

• 确保Jenkins服务器能ping通目标服务器（host）
• 检查目标服务器的防火墙是否开放了SMB服务端口（通常是445端口）
• 用net use \\host\path命令测试共享目录的连接，确认能正常挂载

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