Shopify 应用安装时 OAuth 反复跳转怎么排查

现象#

点安装后在授权页与回调地址之间来回跳，最终报重定向次数过多，应用装不上。

原因#

• 回调里校验 hmac 失败后直接重定向回安装入口，形成死循环
• session cookie 未设置 SameSite=None; Secure，iframe 内拿不到会话
• 回调地址与 Partner 后台配置的 App URL 不一致（http/https、末尾斜杠）
• 授权后没有保存 access token，下次请求又被判定未安装

处理步骤#

1. 在回调入口打印 shop、hmac、timestamp，确认校验通过再往下走
2. 校验失败时返回明确错误页，不要重定向
3. 统一 App URL 与 redirect URL 的协议与斜杠，Partner 后台同步修改
4. 确认 token 落库成功，且按 shop 维度读取

验收标准#

安装流程一次走通，刷新后台页面不再跳授权；token 正确保存并能调用 Admin API。