Webhook 订阅创建失败提示权限不足怎么查

现象#

调用订阅接口返回 Forbidden 或 access denied，后台手动添加却能成功。

原因#

• 应用 scope 里缺少 read_orders 等对应主题的读取权限
• 订阅的 topic 与资源类型不匹配（如对 products/update 却只申请了订单权限）
• 应用未通过审核或被限制创建订阅

处理步骤#

1. 核对 shopify.app.toml 里的 scopes 是否包含该 topic 所需权限
2. 修改 scope 后需要商家重新授权，仅重启应用不会生效
3. 用 webhookSubscriptions 查询现有订阅，确认地址与格式正确
4. 仍失败时改用应用配置文件声明式订阅，再由 app deploy 同步

验收标准#

订阅创建成功并出现在后台 Webhooks 列表；触发测试事件能收到回调。