Webhook 推送字段缺失是版本问题吗

现象#

回调里取某个字段一直是 null，但同一笔数据用 Admin API 查又能拿到。

原因#

• 订阅时指定了较低的 API 版本，payload 结构按旧版本序列化
• 字段本身是异步计算的（如某些履约、税费字段），事件触发时尚未写入
• payload 只包含变更对象的主体，关联数据需要再查一次

处理步骤#

1. 把订阅版本统一到当前稳定版本，并在升级后重新创建订阅
2. 对关键字段做兜底：payload 缺失时用 admin-graphql 按 ID 补查一次
3. 不要依赖 webhook 做实时汇总，改为收到事件后延迟几秒再拉取详情
4. 在日志里记录 X-Shopify-Topic 与 X-Shopify-API-Version，便于定位

验收标准#

关键字段在回调中稳定可取；缺失时可自动补查，不再写入空值。