Shopify Webhook 必须快速返回 200 怎么实现

现象#

端点处理业务超过数秒，Shopify 标为失败并重试，造成重复入账。开发者在请求内同步调用慢 ERP。

原因#

Webhook 要求快速 200/401 等响应。超时会重试。重活应进队列。无幂等键时重试放大事故。

步骤#

1. 接收后立即验签，写入队列，返回 200。
2. 用 X-Shopify-Webhook-Id 或订单 id 做幂等。
3. 监控处理延迟与重试次数。
4. 失败进死信，人工可重放。
5. 阅读 Webhook 最佳实践（shopify.dev）。
6. 压测端点确保 P99 < 平台超时阈值。

验收#

慢 ERP 模拟下仍秒级 200；无重复副作用。