Shopify Storefront API

浏览器请求 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 头,真正的鉴权错误被浏览器遮住,看起来像跨域

处理步骤#

  1. 在 Network 里看请求 URL,确认是 https://{shop}.myshopify.com/api/2026-07/graphql.json
  2. 展开 OPTIONS 预检,确认状态码以及 allow-headers 是否包含令牌头
  3. 去掉 credentials: 'include',Storefront 用 token 鉴权,不需要携带 cookie
  4. 若走自建代理,在响应里补 Access-Control-Allow-Origin 与 Allow-Headers
  5. 先用 curl 复现同一请求,拿到真实状态码后再回浏览器验证

验收标准#

Network 里 OPTIONS 返回 2xx 且带 CORS 头,POST 返回 200,Console 能读到 data 而不是 CORS 报错。

专项深读 · 可复现排查指南

区分 Storefront API 请求与 Admin API 泄密风险

看到浏览器 CORS 报错时先分清 API 类型。Storefront API 可以用于公开店面场景,但 Admin API 访问令牌必须留在服务端。

建议按以下顺序复现和定位

  1. 在 Network 中定位预检 OPTIONS 或真实请求失败的具体域名与响应头。
  2. 确认调用的是 Storefront GraphQL 而不是 Admin GraphQL endpoint。
  3. 检查前端 token 类型、域名限制和 SDK 官方建议的请求方式。
  4. 涉及敏感字段时把调用迁至服务端,通过自己的后端按需返回最小数据集。
  5. 避免关闭浏览器安全限制或部署开放式 CORS 代理作为“解决方案”。

可参考的示例(非真实客户环境)

// 风险排查清单
// URL 是否为 /api/{version}/graphql.json(Storefront)?
// 是否错误使用 /admin/api/...? (Admin,禁止浏览器暴露)
// Chrome Network 是否有 4xx / CSP / 预检失败?
注意:CORS 是浏览器跨源策略;它不会替代 API 权限检查。给浏览器放置 Admin token 会造成严重数据安全风险。

交付与验证记录应该包含什么

从正确环境发起合法请求,前端网络中未出现任何服务端访问令牌。

原始技术资料:Shopify / Google 官方文档。本节为根据公开文档整理的排查方法与模拟示例,未宣称来自客户项目或已在您的店铺实测。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。