Shopify webhook 幂等用哪个字段最可靠

现象#

重试导致同一事件处理两次，用 payload 里的 id 做去重却误杀了正常更新。

原因#

• id 是资源 ID，同一资源会多次更新，不能当事件唯一键
• 应使用 X-Shopify-Event-Id 请求头
• 部分代理会丢掉自定义头

处理步骤#

1. 用 X-Shopify-Event-Id 建唯一索引，插入冲突即跳过
2. 同时记录 X-Shopify-Topic 与 X-Shopify-Shop-Domain
3. 代理层确保透传所有 X-Shopify-* 头
4. 去重表设置 TTL（如 7 天）自动清理

验收标准#

同一事件重复投递只处理一次，资源多次正常更新不被误判为重复。