Shopify Webhook 自动化的关键不是“收到通知后跑一段脚本”，而是定义事件、权限、幂等、顺序、失败队列、重试、监控和人工回滚。跨境独立站常把订单、库存、支付、物流和 CRM 连在一起，任何重复或乱序事件都可能造成重复发货、库存覆盖或客户通知错误。
先定义事件契约
为每个主题记录事件名称、版本、资源 ID、触发条件、字段、签名验证、消费者、延迟容忍和数据保留。区分“事件已接收”“处理成功”“外部系统已确认”，不要只用 HTTP 200 代表业务完成。只申请必要权限，敏感字段脱敏后再写日志。
用幂等和队列处理异常
以事件 ID、资源版本或业务键做幂等；同一事件重复到达时返回已处理结果。事件乱序时检查版本，失败时进入可重试队列，指数退避并设置上限。超过上限要告警、暂停危险动作并允许人工重放，不能无限重试。
上线前做跨境业务回归
测试订单创建/取消、库存变更、支付成功/失败、退款、物流更新、时区、币种、部分发货、重复事件、签名错误、API 限流和外部系统宕机。保留事件 ID、订单 ID、处理状态、重试次数和人工调整原因，验证 Shopify 销售报表 与实际履约一致。
FAQ
Webhook 收到 200 就代表处理成功吗？
不代表。要区分接收、排队、处理和外部确认状态。
如何防止重复发货？
对事件和订单动作做幂等，写入处理状态，并在重复或乱序时人工复核。
失败重试应该多久？
按业务时效设置退避、上限和告警，支付/库存等危险动作不能无限重试。
如何做 Webhook 回滚？
暂停消费者、保留队列、恢复外部系统状态，先小批重放并核对订单和库存。