PR提交时Jenkins构建未触发，求排查遗漏配置项

我来帮你梳理几个容易遗漏的配置点，这些都是我排查这类问题时经常碰到的情况：

• 权限与网络验证：
  首先确认Jenkins用的GitHub凭据（比如个人访问令牌）权限足够——必须要有repo和admin:repo_hook权限，不然Jenkins没法接收PR事件或者发起构建请求。另外，检查Jenkins服务器能不能正常访问GitHub，有没有防火墙、代理规则挡住了双向请求（GitHub发webhook到Jenkins，Jenkins拉取代码到本地）。

• PR Builder的触发规则配置：
  你已经启用了GitHub Pull Request Builder，但可能没开自动触发的开关。进入任务配置的「GitHub Pull Request Builder」模块，展开「Advanced」选项：

  • 确保勾选了Build every pull request automatically without asking（如果需要自动触发PR构建）；
  • 检查「Whitelisted users/organizations」，如果PR提交者不在这个列表里，构建会被拦截；
  • 一定要勾选Use github hooks for build triggering，这是webhook触发构建的核心开关。

• GitHub Webhook的细节配置：
  去仓库的webhook设置里核对这几点：

  • 事件类型要选「Let me select individual events」，然后勾选Pull requests（必要时加上Push）——如果只选了「Just the push event」，PR事件根本不会通知Jenkins；
  • Webhook的URL必须是http://<你的Jenkins地址>/ghprbhook/（注意末尾的斜杠不能省略）；
  • 查看「Recent Deliveries」，检查请求是否成功发送，Jenkins有没有返回200状态码。如果是403/404这类错误，要么是URL错了，要么是Jenkins的权限验证没通过。

• Jenkins全局插件配置：
  进入「Manage Jenkins」→「Configure System」，找到「GitHub Pull Request Builder」的全局设置：

  • 确认已添加正确的GitHub服务器，并且「Test Connection」显示成功；
  • 如果GitHub webhook设置了「Secret」，这里的「Shared secret」必须完全一致，否则Jenkins会拒绝接收webhook请求。

• 分支过滤规则冲突：
  你设置了${sha1}作为分支，但要检查任务的「Source Code Management」部分，有没有设置过于严格的分支过滤规则，把PR对应的分支排除了。另外，PR Builder模块里的「Included branches」「Excluded branches」也别设错，避免把目标分支过滤掉。

• 日志排查兜底：
  如果上面都没问题，去Jenkins的「System Log」（Manage Jenkins → System Log）里搜索「GitHub Pull Request Builder」相关日志，里面会有具体的报错信息——比如权限不足、webhook签名验证失败、分支找不到等，这些日志能直接定位问题根源。

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