Shopify App Proxy 返回 404 怎么排查

现象#

前端请求 /apps/myapp/api 返回 404 或 502，直接访问应用服务器地址却正常。

原因#

• 应用后台的 Proxy URL 与实际路由不一致，末尾斜杠差异也会导致 404
• 子路径前缀（subpath）与前端请求路径不匹配
• 应用未在任何店铺安装，或安装后未重新保存 proxy 配置
• 服务器对 Shopify 的签名参数做了拦截，或强制 HTTPS 跳转丢失查询串

处理步骤#

1. 在应用配置里核对 Proxy URL、subpath 与前端请求路径三者完全一致
2. 用 curl -I https://店铺域名/apps/子路径 看返回码与响应头，确认是否被重定向
3. 在服务端打印收到的 shop、timestamp、signature 参数，验证签名计算是否正确
4. 确认服务端允许 GET/POST 且未开启需要登录的中间件

验收标准#

通过店铺域名访问代理路径返回 200 且响应体正确；签名校验通过。