Shopify Hub
Shopify Webhook：本地测试与 HMAC 调试
需要在本地测 Shopify Webhook、排查 HMAC 验证失败，或把订单与应用生命周期事件打进本地处理器时，从这里开始。
为什么 Shopify Webhook 需要单独一套工作流
Shopify Webhook 是应用开发的核心：订单、商品更新、应用生命周期都依赖稳定投递。但本地测试门槛高：要有公网 URL、要对 raw body 做 HMAC-SHA256，而常见 Web 框架往往在验证前就把 body 解析了。下面的指南按顺序拆解这些问题，减少盲猜。
如何在本地测试 Shopify Webhook
从完整本地闭环开始：捕获订单、商品与应用生命周期事件，再路由到 localhost。
打开指南 ->建议阅读顺序
- 先读 本地测试 ，搭好捕获与转发闭环。
- 若 HMAC 校验失败，再对照文中的 raw body 与密钥核对（后续可补充独立排障篇）。
- 针对订单场景的细粒度调试，可在闭环稳定后结合后台投递日志与捕获到的载荷逐项核对。
相关产品页
- Webhook 调试器 — 捕获并检查 Shopify 投递
- 本地转发 — 将流量路由到本地应用
其他 Webhook 指南
常见问题
为什么 Shopify 的本地测试比想象中难？
Webhook 投递需要公网可达 URL，本地开发天然吃亏；且 Shopify 用 HMAC-SHA256 签 body，很多框架会在你的校验代码看到请求前就把 body 解析掉。
一定要有 Shopify Partners 账号才能测 Webhook 吗？
做应用开发通常需要。若是你自己的店铺，也可在后台「设置 → 通知」等处直接配置 Webhook（视场景而定）。
应该先测哪些事件？
常见起点是 orders/create 与 app/uninstalled——本地开发里最容易踩坑的两类。