Shopify Webhooks

服务多个店铺时 webhook 怎么区分来源

现象#

一个端点接收几十个店铺的事件,处理时不知道该用哪个店铺的 token,日志里也分不清。

原因#

  • 所有店铺共用一个 callback URL 且未带标识
  • 只靠 payload 里的 shop 字段,但部分 topic 不含该字段
  • 并发处理时上下文串号

处理步骤#

  1. 在 callback URL 上带店铺标识,或统一从 X-Shopify-Shop-Domain 头读取
  2. 按 shop 域名查询 token 与配置,禁止全局变量
  3. 处理函数入参显式传 shop,避免依赖隐式上下文
  4. 日志统一带 shop 与 event id,便于串联排查

验收标准#

多店铺事件各归各店处理,无跨店写入,日志可按店铺维度检索。

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