GitHub Webhook未被IntelliJ推送触发问题排查

是否需要配置本地Git元数据？ #

不需要额外配置元数据。Webhook触发逻辑由GitHub服务器端处理，和本地Git配置无关——除非你在推送时主动使用了跳过事件触发的参数。

网页端与IntelliJ推送的核心差异 #

网页端推送 #

GitHub会自动生成完整的事件载荷（payload），包含所有提交、分支相关信息，默认触发push类型的Webhook事件，没有内置的跳过逻辑，只要符合分支触发条件就会触发。

IntelliJ推送可能的问题点 #

• 推送参数异常：检查IntelliJ的Git推送配置，是否添加了--no-verify之外的特殊参数（比如--quiet或自定义抑制事件的参数），部分参数可能导致GitHub无法识别有效推送事件。
• 空提交：如果本地提交是通过git commit --allow-empty生成的空提交，GitHub不会触发push事件的Webhook。
• 分支推送错误：确认IntelliJ推送的分支是否和Webhook配置的触发分支匹配，有没有误推到未设置触发的分支。
• 提交信息含跳过关键词：若提交信息里包含[skip ci]这类关键词，虽然主要针对GitHub Actions，但部分自定义Webhook逻辑可能会忽略该事件（概率较低，但可排查）。
• 浅克隆影响：如果本地仓库是浅克隆（shallow clone），推送时可能导致事件信息不全，不过这种情况很少见。

额外排查建议：去GitHub仓库的Webhook历史页面查看是否有对应推送的请求记录——如果完全没有记录，说明GitHub未收到符合触发条件的push事件；如果有记录但触发失败，再根据错误信息定位问题。

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