配置GitHub Webhook后Jenkins未触发构建，请求排查方案

针对你遇到的情况——GitHub显示Webhook返回200 OK，但Jenkins就是不触发构建，结合你的任务配置，我整理了几个可能的原因和验证步骤：

1. GitHub推送触发器的配置细节或插件状态问题 #

从你的XML配置看，已经添加了<com.cloudbees.jenkins.GitHubPushTrigger>，但有几个点要确认：

• 虽然<spec>为空是正常的（这个字段是给定时轮询用的，推送触发不需要），但要确保Jenkins UI中该任务的构建触发器里确实勾选了「GitHub hook trigger for GITScm polling」——有时候XML配置看起来正确，但实际UI中的设置可能因为插件加载问题没同步。
• 你的GitHub插件版本是1.29.0，Git插件是3.7.0，这些版本都比较老旧了。旧版本插件可能存在Webhook事件解析bug，或者和Jenkins核心版本不兼容的情况，建议升级到最新稳定版后重启Jenkins再测试。

2. Jenkins的Webhook路由或日志排查 #

GitHub返回200不代表Jenkins正确处理了Webhook请求，你可以这样排查：

• 查看Jenkins的系统日志（路径：Manage Jenkins → System Log），搜索「GitHubPushTrigger」或「webhook」关键词。如果Webhook被正确接收，应该能看到类似「Received GitHub push for repo XXX from XXX」的日志；如果有错误，日志里也会给出具体原因（比如事件解析失败、权限问题等）。
• 确认GitHub Webhook的URL是否正确：必须是http://你的Jenkins地址/github-webhook/（注意结尾的斜杠不能少）。如果Jenkins部署在子路径下，也要把路径加上，比如http://your-domain/jenkins/github-webhook/。少了斜杠可能导致Jenkins接收到请求但无法路由到正确的处理程序，虽然返回200但不触发构建。

3. SCM轮询与分支匹配问题 #

GitHub推送触发本质上是通过Webhook通知Jenkins执行一次SCM轮询，如果轮询没检测到分支变化，就不会触发构建：

• 你的分支配置是<name>**</name>，理论上匹配所有分支，但要确认你推送的分支（比如main、master）是否真的被这个规则覆盖。可以尝试在UI中修改分支规则为具体分支名（比如*/main）测试，排除分支匹配的问题。
• 手动执行一次SCM轮询：在任务页面点击「立即构建」旁边的下拉菜单，选择「SCM轮询」，看是否能检测到分支变化并触发构建。如果轮询都没反应，说明SCM配置本身有问题。

4. 公开仓库的凭证问题（虽然你认为不需要，但还是要验证） #

你说公开仓库无需凭证是对的，但要确保Jenkins能正常拉取代码：

• 手动触发一次构建，看是否能成功拉取仓库代码。如果手动拉取失败，说明即使Webhook到了，Jenkins也会因为拉取代码失败而跳过构建。这种情况下，检查GitSCM的URL是否正确（你的配置里是HTTPS地址，公开仓库确实无需凭证，但要确保Jenkins服务器能访问GitHub）。

快速验证步骤 #

1. 先手动触发任务，确认任务本身能正常执行（拉取代码+运行touch /tmp/JENKINS_WORKS），排除任务自身的问题。
2. 查看GitHub Webhook的「Recent Deliveries」，点开详情看请求体和Jenkins的响应内容，有时候200响应里会包含错误信息。
3. 检查Jenkins系统日志，确认Webhook请求是否被正确处理。

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