Webhook 为什么会重复?给 SaaS 做幂等、重试和事件对账
支付或订阅服务发送 Webhook 时,网络超时会让发送方无法确定接收方是否处理成功。即使你认为“只发一次”,也应把接收端设计成可能收到重复、延迟或乱序事件。
安全接收
按服务商要求验证签名,通常需要对原始请求体验签;不要先重新序列化 JSON 再计算签名。检查时间戳容忍窗口,密钥定期轮换;验签通过不代表业务一定可执行,仍要检查事件类型、资源归属和状态转换。
幂等处理
在数据库给供应商事件 ID 建唯一约束。在一个事务内插入事件记录并更新业务状态;唯一约束冲突时返回成功而不重复执行。如果副作用发生在事务外,例如发邮件,使用 outbox 记录待发送任务,消费者使用独立幂等键。应尽快确认接收,将耗时处理交给队列或后台任务,具体超时时间与重试策略遵循供应商文档。
乱序与对账
不要假设“取消”一定在“创建”之后到达。使用事件版本、状态机或查询供应商当前状态判断能否转换;对需要精确时间顺序的业务保留原始事件。定期从供应商拉取账单或订阅状态,与本地账本对账;重放失败任务之前先修复根因并确认不会重复扣费。
日志记录事件 ID、处理结果、重试次数与关联订单,但不要保存完整敏感支付数据。演练签名失败、重复投递、事务中断和乱序事件,比只测试一次正常付款更有价值。