Shopify webhook payload 太大被截断怎么办

现象#

商品包含大量变体或富文本时，收到的 payload 里部分字段为空或缺失，跟文档不一致。

原因#

• payload 有体积上限，超大对象会被裁剪
• 包含 body_html 等大字段时更容易触发
• 主题/应用依赖 payload 全量数据

处理步骤#

1. payload 只当「变更通知」，用 ID 回查 Admin API 拿完整数据
2. 对商品类事件只取 id、updated_at，其余按需查询
3. 把回查做成异步任务，避免阻塞 webhook 响应
4. 对批量变更合并处理，减少 API 调用

验收标准#

即使 payload 被裁剪，业务数据仍完整正确，回查逻辑有缓存与限流保护。