Shopify Webhook 怎么做得可靠：重复通知、失败重试和版本升级一起管

订单创建、退款、库存和客户更新常依赖 Webhook 推动 ERP、OMS、CRM 与营销自动化。真实环境里，通知可能重复、延迟或乱序，接收端也可能因部署与网络暂时失败。若业务代码假设每条通知只来一次，就会出现重复发货、库存反复扣减或会员积分错误。

接收接口只做必要动作

1. 验证来源。 使用 Shopify 提供的 HMAC 签名校验请求，不凭 IP 或路径判断。
2. 保存原始事件。 记录 topic、shop、event ID、API version、接收时间与原始 payload。
3. 快速返回成功。 重业务放入队列，不在接收请求里同步跑完整 ERP 流程。
4. 异步执行并可重试。 每个处理步骤有状态、错误信息和人工补偿入口。

幂等不是简单去重

同一个事件重复到达时，系统不应重复产生业务结果。可以用事件 ID 建唯一约束，也可以用“店铺 + 资源 ID + 业务动作”作为幂等键。关键是把“收到过”与“执行成功”分开：第一次收到但处理失败，第二次仍应继续完成，而不是被粗暴丢弃。

每天做一次业务对账

• Shopify 订单数与 OMS 新增订单数是否一致。
• 退款、取消和履约状态是否存在长时间未同步记录。
• 失败队列是否持续增长，是否集中在同一 topic 或商店。
• 当前接收版本与应用声明版本是否一致。

资料来源与核验口径

本文优先引用平台官方文档与公开标准。功能、费用和合规要求可能调整，实施前应再次核对商店后台与目标市场规定。

1. Shopify.dev：Manage webhook subscriptions
2. Shopify.dev：Implementing idempotency
3. Shopify.dev：API versioning