Shopify本地开发遇OAuth错误：redirect_uri未白名单，已配置仍无效求助

• 严格匹配URI的每一个字符：Shopify对重定向URI的大小写、路径、端口、前缀都做精确校验。比如localhost:3000/auth/shopify/callback和localhost:3000/Auth/Shopify/Callback、localhost:3000/auth/shopify/callback/（带结尾斜杠）都不视为同一个URI，必须和你代码里实际发起请求的redirect_uri参数完全一致。

• 核对ngrok的实时域名：ngrok每次重启会生成新的随机域名，如果你之前配置的是旧域名，现在用的新域名肯定不匹配。复制当前ngrok终端显示的完整域名（比如https://xyz789.ngrok.io），加上完整回调路径（比如/auth/shopify/callback），更新到后台白名单里，确保没有拼写错误。

• 检查后台配置的URI完整性：
  进入合作伙伴后台你的App页面，到「App setup」->「Redirection URLs」区域，确认添加的是完整的回调地址，不是只加域名。比如不能只填https://your-ngrok-domain.com，必须是https://your-ngrok-domain.com/auth/shopify/callback这类包含具体路径的完整URI。

• 验证代码里的redirect_uri配置：
  检查本地代码中初始化Shopify API时设置的redirect_uri，比如.env文件里的SHOPIFY_APP_REDIRECT_URI环境变量，确保和后台白名单里的URI完全一致，没有多空格、拼写错误。

• 清除浏览器缓存/用无痕模式测试：浏览器可能缓存了旧的OAuth会话信息，导致请求时带了错误的重定向URI。用无痕模式打开合作伙伴后台重新授权，或者清除浏览器对应域名的Cookie后再试。

• 确认App类型对应的配置位置：

  • 公共App：重定向URI配置在合作伙伴后台的App setup里
  • 自定义私有App：配置在测试商店的「Apps」->「Manage private apps」-> 对应App的设置页面
    别搞混了配置入口，导致白名单加错地方。

• 用Shopify CLI校验配置（如果用CLI开发）：
  运行shopify app config list查看当前CLI配置的redirect_uri，要是和后台不一致，用shopify app config set redirect_uri="你的正确URI"更新配置，再重新启动本地服务。

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