浏览器请求 Storefront API 报 CORS 被拦截怎么查
现象#
本地 fetch 时控制台报 blocked by CORS policy: No 'Access-Control-Allow-Origin' header,Network 里只有一个失败的 OPTIONS 或 401,同样的请求放到 Postman 却能成功。
原因#
- 请求打到了 /admin/api/.../graphql.json,Admin 端点不面向浏览器跨域使用
- 通过自建反代或 Worker 转发,响应丢了 Access-Control-Allow-Origin 与 Allow-Headers
- 请求带了 credentials: include,而响应是通配来源,浏览器会直接拒绝
- 失败的 401 响应本身没有 CORS 头,真正的鉴权错误被浏览器遮住,看起来像跨域
处理步骤#
- 在 Network 里看请求 URL,确认是
https://{shop}.myshopify.com/api/2026-07/graphql.json - 展开 OPTIONS 预检,确认状态码以及 allow-headers 是否包含令牌头
- 去掉
credentials: 'include',Storefront 用 token 鉴权,不需要携带 cookie - 若走自建代理,在响应里补
Access-Control-Allow-Origin与 Allow-Headers - 先用 curl 复现同一请求,拿到真实状态码后再回浏览器验证
验收标准#
Network 里 OPTIONS 返回 2xx 且带 CORS 头,POST 返回 200,Console 能读到 data 而不是 CORS 报错。
专项深读 · 可复现排查指南
区分 Storefront API 请求与 Admin API 泄密风险
看到浏览器 CORS 报错时先分清 API 类型。Storefront API 可以用于公开店面场景,但 Admin API 访问令牌必须留在服务端。
建议按以下顺序复现和定位
- 在 Network 中定位预检 OPTIONS 或真实请求失败的具体域名与响应头。
- 确认调用的是 Storefront GraphQL 而不是 Admin GraphQL endpoint。
- 检查前端 token 类型、域名限制和 SDK 官方建议的请求方式。
- 涉及敏感字段时把调用迁至服务端,通过自己的后端按需返回最小数据集。
- 避免关闭浏览器安全限制或部署开放式 CORS 代理作为“解决方案”。
可参考的示例(非真实客户环境)
// 风险排查清单
// URL 是否为 /api/{version}/graphql.json(Storefront)?
// 是否错误使用 /admin/api/...? (Admin,禁止浏览器暴露)
// Chrome Network 是否有 4xx / CSP / 预检失败?注意:CORS 是浏览器跨源策略;它不会替代 API 权限检查。给浏览器放置 Admin token 会造成严重数据安全风险。
交付与验证记录应该包含什么
从正确环境发起合法请求,前端网络中未出现任何服务端访问令牌。
原始技术资料:Shopify / Google 官方文档。本节为根据公开文档整理的排查方法与模拟示例,未宣称来自客户项目或已在您的店铺实测。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。