Shopify 迁移与导入

导入 300 个商品后 ERP 没收到一条商品 webhook

现象#

导入完成后 ERP 新增商品为 0,后台 Webhooks 的 delivery log 只有导入前的手工测试记录,库存同步任务空跑一遍。

原因#

  • 批量导入是后台异步任务,事件不按行逐条投递,应用等不到 300 次 create
  • 导入时商品先落库再发布,只订阅 products/create 会漏掉后续的发布变更
  • 接收端处理超过 5 秒触发超时重试,连续失败后订阅被自动停用
  • 应用锁在旧 API 版本,payload 字段与解析逻辑不匹配,收到事件也写不进库

处理步骤#

  1. 同时订阅 products/create 与 products/update,不要只挂一个
  2. 导入结束后按 updated_at:>'2026-11-01' 拉一次增量做补偿
  3. 在 Settings > Notifications > Webhooks 看 delivery log 的失败码
  4. 接收端改成先入队再处理,保证 5 秒内返回 200
  5. 建每日对账任务,两边商品数差值超过 50 就告警

验收标准#

导入后 10 分钟内 ERP 商品数与后台一致,Webhooks 日志里能看到 products/update 的成功投递记录。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。