配置Jenkins Git凭证遇权限问题：无法连接Git仓库

排查步骤及解决方案 #

1. 核对Jenkins运行时的环境变量 #

Jenkins在Tomcat中运行时，可能未加载tomcat用户的完整环境变量（比如PATH、HOME），导致Git或SSH配置无法生效。

• 进入Jenkins的「Manage Jenkins」>「Script Console」，运行以下代码查看当前环境：

  println System.getenv("PATH")
  println System.getenv("HOME")
  

• 将结果和你手动登录tomcat用户时执行echo $PATH、echo $HOME的输出对比。如果PATH不含Git路径，或HOME不是tomcat用户的家目录，就会引发问题。

修复方式：

• 修改Tomcat启动脚本，在启动前添加环境变量：

  export HOME=/home/tomcat
  export PATH=$PATH:/usr/bin/git  # 替换为你的Git实际安装路径
  

• 或在Jenkins的「Manage Jenkins」>「Global Tool Configuration」里直接指定Git的完整路径，不依赖系统环境变量。

2. 检查SSH密钥权限与Jenkins访问权限 #

即使tomcat用户本地能正常访问，Jenkins运行时可能因权限问题无法读取SSH密钥文件：

• 确保~/.ssh目录权限为700：

  chmod 700 /home/tomcat/.ssh
  

• 确保私钥文件（如id_rsa）权限为600：

  chmod 600 /home/tomcat/.ssh/id_rsa
  

• 确保公钥文件（id_rsa.pub）权限为644：

  chmod 644 /home/tomcat/.ssh/id_rsa.pub
  

同时确认Jenkins凭证类型为SSH Username with private key，若选择上传私钥，要保证内容和~/.ssh/id_rsa完全一致，无多余换行或空格。

3. 在Jenkins内直接测试Git命令 #

新建一个「Freestyle project」，添加「Execute shell」步骤，执行以下命令排查细节：

whoami
git ls-remote -h -- myUser@myServer:myProject.git HEAD
ssh -v myUser@myServer  # 打印SSH连接的详细日志

运行项目后查看控制台输出，确认：

• 执行命令的用户是否为tomcat
• SSH连接是否尝试使用了正确的密钥
• 是否出现明确的权限错误提示

4. 验证Git仓库地址与服务器权限 #

• 确认Jenkins项目中输入的仓库地址myUser@myServer:myProject.git和本地执行的完全一致，无拼写错误。
• 检查Git服务器上myProject.git仓库是否存在，且tomcat用户的公钥已添加到Git服务器myUser用户的~/.ssh/authorized_keys文件中。

5. 临时关闭主机密钥验证（测试用） #

若为首次连接Git服务器，Jenkins可能因未保存主机密钥拒绝连接。可在Jenkins的shell步骤中先执行：

ssh-keyscan myServer >> /home/tomcat/.ssh/known_hosts

再测试Git连接，确认是否为主机密钥问题。若验证有效，可将该主机密钥永久写入known_hosts文件。

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