导入 300 个商品后 ERP 没收到一条商品 webhook
现象#
导入完成后 ERP 新增商品为 0,后台 Webhooks 的 delivery log 只有导入前的手工测试记录,库存同步任务空跑一遍。
原因#
- 批量导入是后台异步任务,事件不按行逐条投递,应用等不到 300 次 create
- 导入时商品先落库再发布,只订阅 products/create 会漏掉后续的发布变更
- 接收端处理超过 5 秒触发超时重试,连续失败后订阅被自动停用
- 应用锁在旧 API 版本,payload 字段与解析逻辑不匹配,收到事件也写不进库
处理步骤#
- 同时订阅
products/create与products/update,不要只挂一个 - 导入结束后按
updated_at:>'2026-11-01'拉一次增量做补偿 - 在
Settings > Notifications > Webhooks看 delivery log 的失败码 - 接收端改成先入队再处理,保证 5 秒内返回 200
- 建每日对账任务,两边商品数差值超过 50 就告警
验收标准#
导入后 10 分钟内 ERP 商品数与后台一致,Webhooks 日志里能看到 products/update 的成功投递记录。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。