GitHub Webhook无法触发Jenkins旧流水线项目构建如何解决

• 前期源码管理采用自建GitLab服务，通过配置GitLab Webhook触发Jenkins侧全量项目流水线，GitLab初始访问地址为https://git.fulcrumdigital.com，版本升级后访问地址变更为https://autobuild.fulcrumdigital.com
• 近期完成代码托管平台迁移，正式启用github.com服务并创建私有组织，所有项目源码均托管在该私有组织下
• 为对应项目配置GitHub Webhook后，事件可正常投递至Jenkins服务，但Jenkins无法触发对应项目的构建任务，相关报错截图如下：
  
• Jenkins全局配置页面未查询到该Webhook的相关配置信息，对应Jenkins运行日志截图如下：
  
• 故障范围已确认：仅此前配置过GitLab Webhook的存量旧流水线项目存在该问题，Jenkins上新建的流水线项目可被GitHub Webhook正常触发构建
• 核心诉求：落地可行解决方案，实现GitHub Webhook正常触发存量旧流水线项目的构建任务

存量旧流水线项目残留GitLab插件的触发配置，GitLab插件的Webhook事件拦截优先级高于GitHub插件，会先接收到GitHub投递的Webhook事件，再因为项目配置的源码仓库地址仍为旧GitLab地址、和GitHub事件携带的仓库地址不匹配，直接丢弃事件不触发构建，这也是新流水线正常、旧流水线异常的核心原因。

方案1：逐项目手动修复（适合存量项目少于20个的场景） #

• 进入目标旧流水线的配置页面，找到「构建触发器」板块，取消所有GitLab插件相关的触发勾选（典型选项为Build when a change is pushed to GitLab），保存配置清理旧触发规则缓存
• 找到「源码管理」板块，删除原有旧GitLab仓库地址配置，替换为对应项目在GitHub私有组织下的仓库地址，绑定具备仓库读取、Webhook管理权限的GitHub PAT凭证，测试连通性确保Jenkins可正常拉取代码
• 回到「构建触发器」板块，勾选GitHub插件对应的触发选项GitHub hook trigger for GITScm polling，保存配置
• 进入对应GitHub仓库的Webhook设置页，确认Payload地址为[你的Jenkins服务地址]/github-webhook/（注意末尾斜杠不能漏），Content type选择application/json，勾选push、PR等需要触发构建的事件，发送测试推送验证
• 验证标准：测试推送后Jenkins对应项目自动触发构建，系统日志无Webhook匹配失败报错即为修复完成

方案2：Groovy脚本批量修复（适合存量项目量大的场景） #

• 操作前务必备份Jenkins主目录下的jobs目录，避免配置丢失
• 进入Jenkins脚本控制台（路径：Manage Jenkins > Script Console），执行Groovy脚本批量完成以下操作：
  • 遍历所有流水线项目，移除配置中残留的GitLab Webhook触发规则
  • 将项目源码管理配置中匹配git.fulcrumdigital.com、autobuild.fulcrumdigital.com的旧仓库地址，按规则替换为对应GitHub私有组织下的仓库地址
  • 统一为所有存量项目开启GitHub hook trigger for GITScm polling触发规则
• 脚本执行完成后重启Jenkins服务加载新配置，批量校验GitHub侧各仓库Webhook配置正确性，抽样验证项目触发状态即可

不要在保留旧GitLab触发配置的基础上直接叠加GitHub触发规则，否则事件会被高优先级的GitLab插件拦截丢弃，永远无法触发GitHub构建逻辑
GitHub Webhook的Payload地址必须以/github-webhook/结尾，漏写末尾斜杠会直接返回404错误
如果是多分支流水线（Multibranch Pipeline）项目，还需要删除分支源配置中的旧GitLab源，新增GitHub分支源并绑定对应凭证，否则无法正常匹配Webhook事件触发分支构建

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