用途:在 Magento 2(含 Adobe Commerce)上通过 GraphQL 构建无头店面、原生移动应用或 PWA Studio 扩展,替代 REST 调用,也可编写自定义 resolver 暴露第三方或自定义模块数据。
主要能力:端点 /graphql,公开目录数据无需管理员令牌;支持商品目录与搜索(分页、聚合、SimpleProduct/ConfigurableProduct 等内联片段)、游客购物车创建与加购、可配置商品变体加购、客户登录获取 Bearer 令牌、客户购物车与订单历史查询,以及自定义 GraphQL resolver(schema.graphqls + ResolverInterface)。
使用方式:以 HTTP POST 调用 /graphql,可用 Apollo Client 或 fetch 封装;请求头带 Content-Type、Store(多店铺视图)与可选 Authorization: Bearer。游客购物车返回 UUID,需持久化到 cookie;登录后用 mergeCarts 合并。自定义 resolver 新增 schema 后需执行 bin/magento setup:upgrade。
适用场景:React/Vue/Next.js 无头前端、移动端、PWA Studio 扩展、无头 CMS 与商品目录集成。
限制与注意:GraphQL 出错仍返回 200,需检查 errors 数组;游客购物车 24 小时不活动过期;令牌应存 httpOnly cookie;多店铺必须传 Store 头;变体库存需查 variants.product;商品可见性为“Not Visible Individually”不会出现在目录查询。资料未提供具体收费、价格与平台支持细节。