Stripe CLI listen 漏收事件:测试事件与转发链路排查
针对 Stripe CLI 没有收到全部事件的公开案例,按事件类型、监听会话与本地转发逐步验证。
排障原则:先保留错误截图、时间点和网络出口信息;不要在故障期反复切换设备或 IP,以免扩大平台的异常信号。
先给结论
当 stripe listen 没有收到预期事件,先核对事件属于测试还是生产模式、监听会话是否仍有效,以及 CLI 是否筛选了事件。公开 Stripe CLI Issue #600 是相似现象记录,不是通用故障结论。
排查顺序
- 根据 Stripe Webhook 官方文档 确认当前 CLI 工作流与目标环境一致。
- 只发送一个可识别的测试事件,记录事件类型和时间,不复制客户或支付资料。
- 确认监听进程未退出、没有被另一个终端替换,并检查本地转发端点仍可处理请求。
- 将“CLI 没显示事件”“CLI 显示但本地端点未处理”“端点处理后业务未更新”拆成独立问题。
- 多次受控复现后仍漏收时,带上 CLI 版本、事件类别和脱敏时间线升级处理。
验证
修复通过应同时观察到:测试事件在预期会话出现、本地端点收到转发、业务测试记录与事件类别一致。不要用一次偶然出现的事件替代连续验证。
常见问题
没有看到事件是否代表 Stripe 没有发送?
不能据此下结论。先确认测试事件、监听会话、事件筛选与本地端点是否属于同一环境。