Jenkins与GitHub私有仓库自动SCM轮询集成故障排查

1. 彻底检查流水线任务的SCM配置 #

进入对应流水线任务的配置页，找到「源码管理」模块：

• 确认Git仓库URL完全替换为SSH格式（例如git@github.com:xxxxxx/zzzzz.git），没有残留HTTPS地址
• 检查「Credentials」下拉框是否选中了正确的SSH密钥凭证，而非旧的HTTPS密码/PAT凭证
• 如果是Pipeline脚本，检查脚本内的git指令是否硬编码了HTTPS地址，比如：

  // 错误示例
  git url: 'https://github.com/xxxxxx/zzzzz.git'
  

  需要修改为SSH地址并指定对应凭证：

  git url: 'git@github.com:xxxxxx/zzzzz.git', credentialsId: '你的SSH凭证ID'
  

2. 清理工作区的Git远程缓存 #

Jenkins工作区可能保留了旧的Git远程配置，导致轮询时仍调用HTTPS地址：

1. 登录Jenkins服务器，进入任务工作区目录（比如/var/lib/jenkins/workspace/zzzzz）
2. 执行命令查看当前远程地址：

   git remote -v
   

3. 如果输出是HTTPS地址，执行命令替换为SSH：

   git remote set-url origin git@github.com:xxxxxx/zzzzz.git
   

3. 检查Jenkins全局Git配置 #

进入「Manage Jenkins」→「Global Tool Configuration」→「Git」：

• 确认没有全局层面绑定的旧HTTPS仓库配置
• 切换到jenkins用户，检查Git全局配置：

  su jenkins
  git config --global --list
  

  如果发现remote.origin.url为HTTPS地址，执行以下命令删除：

  git config --global --unset remote.origin.url
  

4. 更新Git插件并重启Jenkins #

• 进入「Manage Jenkins」→「Plugins」，确保Git插件是最新版本，旧版本可能存在配置缓存bug
• 重启Jenkins服务，让所有配置变更生效：

  sudo systemctl restart jenkins
  

5. 确认Webhook与轮询的关联逻辑 #

虽然用Webhook触发，但Jenkins的「Poll SCM」会独立检查仓库变更：

• 确认任务配置中「Build Triggers」里的「Poll SCM」是基于当前SCM配置，而非旧缓存
• 验证Webhook的Payload URL可正常访问，避免因网络或权限问题导致触发失败

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