Shopify公共应用App Proxy请求返回404错误问题求助

问题排查及解决方案 #

• 重新安装应用同步配置
  公共应用修改App Proxy配置后，不会自动同步到已安装的店铺，必须先将应用从测试店铺卸载，再重新安装才能让新的代理规则生效，这是公共应用和自定义应用的核心差异之一，也是当前场景最高概率的触发原因。
• 等待代理配置缓存生效
  Shopify的App Proxy配置存在最长15分钟的缓存时间，修改配置后不要立即测试，等待10~15分钟再验证，避免缓存导致的配置不生效问题。
• 核对代理配置项
  确认Shopify后台App Proxy配置项完全正确：
  • Prefix下拉框选中的是你自定义的tools，而非默认的其他选项
  • Subpath填写的是sb
  • 代理URL填写完整的https://xxx.ngrok.io/sb，没有漏填路径或者协议
• 检查应用接收的实际请求路径
  在你的应用服务端添加全局日志，打印所有进来的请求的完整路径、请求方法。从店铺发起请求后，确认服务端收到的路径是否为/sb/sessions，如果收到的路径和预期不符，可根据实际路径调整配置：
  如果你希望Shopify转发时保留完整的访问路径，可将代理URL修改为https://xxx.ngrok.io，此时/tools/sb/sessions的请求会被转发到https://xxx.ngrok.io/tools/sb/sessions
• 排除路由及校验逻辑拦截
  • 确认Shopify CLI生成的应用没有给服务端路由加/api之类的统一前缀，你的sessions接口确实挂载在/sb/sessions路径下
  • 临时关闭App Proxy请求的签名校验逻辑测试，部分模板默认开启的签名校验如果报错可能直接返回404状态码

内容的提问来源于stack exchange，提问作者user1452030