Shopify webhook 连续失败后被自动停用怎么恢复

现象#

某天开始完全收不到事件，后台 webhook 列表里该订阅消失或状态异常，历史投递全是失败。

原因#

• 端点连续多次返回非 2xx，Shopify 自动删除订阅
• 服务器证书过期或域名解析失败
• 端点响应超过 5 秒被判超时
• 防火墙拦截了 Shopify 的出口 IP

处理步骤#

1. 先修端点：确认 HTTPS 证书有效、响应在 1 秒内返回 200
2. 在应用里做启动自检，缺失的订阅自动重建
3. 用 webhookSubscriptionCreate 重新订阅并用测试事件验证
4. 加监控：投递失败率、5xx 比例、响应时长告警

验收标准#

订阅恢复且连续 24 小时无失败，测试事件能在 1 秒内被接收并处理。