后到的数据不一定更新
系统先收到付款成功通知,随后却在没有取消操作的情况下变回待付款。可能原因之一是旧事件的webhook较晚送达,覆盖了新状态。应检查事件顺序和状态转换规则,不能只提高服务器速度;还要将其与同一事件重复送达区分开来。
Webhook是源系统向目标系统发送的事件通知,但事件产生、发送、入队和处理完成属于不同时间点。Stripe明确说明不保证按事件产生顺序投递,并说明可以通过API获取缺失对象。这只是一个供应商的例子,设计实际集成前仍应阅读所用系统的行为约定。
区分重复事件与过时更新
假设事件A表示订单待付款,B表示已付款。若先处理B,基于事件ID的去重仍会接受A,因为它有不同ID,即使没有重复记录也可能导致状态倒退。反过来,仅保证顺序也不能防止重复开收据或重复发货,两类控制都需要。
至少记录事件ID、业务对象ID、事件类型、源端产生时间(如有)、接收时间、处理结果及下游关联ID。这样才能追查哪个事件修改了哪条记录,笼统的成功日志不够。日志中的个人信息及访问权限应按实际需要限制。
确定权威状态与明确规则
若源端提供可靠的当前状态API,可把webhook作为读取最新对象的触发信号,再按明确规则更新目标端。这能减少对旧快照的依赖,但会增加请求,并需处理延迟、限流或状态尚未可见。读取失败时应保留带原因的待处理任务并受控重试,不能猜测为成功。
若源端保证同一对象的版本号单调递增,可在写入前比较版本。不能凭事件ID外观或接收时间猜顺序;时间戳可能相同,也可能来自不同系统时钟。业务状态并非总是线性推进,例如退款或重新开启任务可能完全合法,禁止所有看似倒退的变化也会拦截正确事件。
使用队列仍需并发控制
即使已有队列,两个worker仍可能读取相同状态并互相覆盖。开发人员应按对象串行处理,或结合系统情况使用写入时版本校验和数据库事务。接收webhook时应按供应商说明验证签名,并在可靠保存任务后确认接收;接收确认不代表业务操作已经完成。
发货、发送邮件或出具文件等外部操作,需要保留已完成操作的引用,并在下游响应不明确时核对结果。未检查既有影响前,不应把全部事件重放到生产系统。文末Chawinnix关于重复提交的延伸阅读有助于设计去重,但仍需结合本文的顺序和状态规则。
测试业务结果,而不仅是HTTP成功
测试应覆盖正常顺序、逆序、重复、并发及API读取失败。对同一测试订单核查最终状态是否与源端一致,外部操作是否仅按预期发生,未确认任务是否仍明确显示待处理。保存前后结果及日志,以区分数据问题和worker问题。
上线前,流程负责人应确认权威数据源、允许的状态变化、待处理任务责任人,以及发现差异时如何停止外部操作。Chawinnix服务页面列有IT系统及自动化服务。提供去除敏感信息的日志样例和集成图,比只说系统慢更有助于定位问题。
