服务多个店铺时 webhook 怎么区分来源
现象#
一个端点接收几十个店铺的事件,处理时不知道该用哪个店铺的 token,日志里也分不清。
原因#
- 所有店铺共用一个 callback URL 且未带标识
- 只靠 payload 里的
shop字段,但部分 topic 不含该字段 - 并发处理时上下文串号
处理步骤#
- 在 callback URL 上带店铺标识,或统一从
X-Shopify-Shop-Domain头读取 - 按 shop 域名查询 token 与配置,禁止全局变量
- 处理函数入参显式传 shop,避免依赖隐式上下文
- 日志统一带 shop 与 event id,便于串联排查
验收标准#
多店铺事件各归各店处理,无跨店写入,日志可按店铺维度检索。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。