开发指南

系统集成偶尔漏单:Webhook 与 API 失败怎样恢复?

同一通知可能来几次,也可能迟到。记下每个事件收到后做了什么,出错时才查得到是否要重试、补单或交人跟进。

ProApp 编辑发布及核对日期
网络交换机与蓝黄网线
AI 生成情境图,用作说明文章主题。

本文以假设流程说明设计方法,并非客户案例。

流程设计示意
  1. 保存事件
  2. 安全处理与重试
  3. 定期核对

请求超时后,先查对方有没有生成订单

两个系统都正常运行,交接数据时仍可能漏了一次。请求超时尤其难判断:对方可能已写入数据,只是还没有回复;这时重发,就可能生成两张订单。集成记录要分清收到通知、开始处理和确认结果,才有依据决定下一步,也避免因不敢重试而漏单。

集成工具是否支持重试和重新执行?

检查现有集成工具是否有错误日志、重试和重新执行功能。Stripe 的 Webhook 文档也说明了重复通知和到达顺序的问题。自行开发集成时,要按各平台的规则处理,不能假设通知只到达一次,或总是按顺序到达。

记住每个事件处理到哪一步

先处理一条重要流程,验证通知来源并保存事件编号,再排队执行。失败的项目要显示原因,重试前先查动作是否已完成。未能自动恢复的记录,让同事按既定程序跟进,并定期与来源系统核对数据,找出遗漏的部分。

重新执行一次,是否会再次扣款?

把同一事件重新执行一次,确认不会再次扣款或发货,再试通知顺序颠倒、接口限流、对方停机和超时。工作只完成一部分时,也要知道如何接着处理。验收时要找得到真正遗漏的记录、能补回,通知也能让同事判断哪些失败需要跟进。

整理一次失败的处理记录

准备去除个人信息的事件时间线、处理记录、接口文档、错误消息和正常结果的例子。

想处理类似问题?

告诉我们目前怎样做、用了哪些工具,以及想改善什么。我们可一起看看是调整现有系统、加入连接,还是需要新开发。