GitLab Pipeline Webhook未发送全部状态事件，如何解决？

开发者阿泽

2026-7-29

问题解答

核心原因分析

GitLab的Webhook默认不会触发所有pipeline状态的通知，尤其是那些短生命周期的中间状态（比如created、pending、preparing），在共享运行器环境下，这些状态可能转瞬即逝，还没来得及触发Webhook就进入了running状态。另外，Webhook的事件订阅配置也可能没覆盖到这些状态。

具体排查与修复步骤

确认Webhook的事件勾选范围
进入项目的Webhook设置页面，检查是否勾选了Pipeline events下的所有细分状态触发器。有些版本的GitLab需要手动勾选Pipeline created、Pipeline pending等具体事件，而不是只勾选顶级的Pipeline events。
测试拉长中间状态的持续时间
共享运行器调度速度极快，created→pending→running的转换可能在几秒内完成。可以给job添加初始延迟（比如在echo hello前加sleep 10），拉长中间状态的持续时间，测试是否能收到这些状态的Webhook。
验证GitLab版本的事件支持
部分旧版本的GitLab对pipeline早期状态的Webhook支持不完善，确认你的GitLab版本是否支持这些状态的通知。比如GitLab 13.x之前，某些中间状态的Webhook可能未被实现。
查看GitLab的Webhook触发日志
进入项目的Settings > Webhooks，点击Webhook条目后的View details，查看触发日志，确认这些早期状态是没被触发，还是你的接收服务器没正确捕获（比如网络延迟、服务器处理慢导致丢包）。
检查接收服务器的处理能力
确保你的简易Web服务器能处理快速连续的Webhook请求，有些轻量服务器可能因为并发或处理速度问题，漏掉了早期状态的通知。可以在服务器端增加完整的请求日志，确认所有收到的请求都被记录。