如何实现GitHub PR必需状态检查失败时自动通知作者？

一、状态检查失败的通知配置（邮件/Slack） #

GitHub原生通知确实没有直接针对「PR必需状态检查失败」的开关，但可以通过以下两种方式实现：

• 仓库级Webhook + 第三方通知服务：
  在仓库的Webhook设置中，勾选Statuses事件（该事件会关联PR的状态检查结果），将Payload URL指向Slack的Incoming Webhook或者自定义邮件转发服务。在接收端过滤状态为failure、context属于必需检查项的事件，关联PR作者后发送通知。
• GitHub Apps集成：
  使用支持PR状态检查通知的GitHub Apps（比如Slack官方的GitHub集成），配置触发规则：当PR的必需状态检查失败时，自动向PR作者发送Slack消息或邮件。这类App支持自定义触发条件，无需依赖GHA。

二、触发Jenkins工作流的Webhook事件 #

你之前的Jenkins流水线未触发，问题出在事件选择和规则配置上：

• 正确选择Webhook事件：
  针对PR的状态检查，应该勾选Webhook中的Pull requests事件，而非Statuses。因为PR的状态检查结果会包含在pull_request事件的字段中，或在PR的synchronize/opened等子事件触发时附带状态更新；Statuses事件是仓库全局提交状态，不一定直接关联PR，容易匹配失败。
• 修正Jenkins流水线触发规则：
  将eventName改为pull_request，调整JMESPath过滤规则，示例如下：

  triggers {
      eventTrigger jmespathQuery("provider=='github' && eventName=='pull_request' && webhook.pull_request.statuses[?context=='Gearset 3. uat to UAT Deploy' && state=='failure']")
  }
  

  同时确保仓库Webhook已勾选Pull requests事件，且Jenkins的GitHub Webhook触发器已正确配置接收该事件。

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