Shopify Storefront API查询网页端购物车报Invalid global id问题咨询

1. 查询语法错误原因 #

你的报错根源是传入的ID不符合Storefront API的全局ID规范，并不是语法逻辑错误：

• Storefront API要求的购物车ID是base64编码的gid://shopify/Cart/[Storefront体系专属的购物车UUID]，自行对网页端普通cart token、Admin/webhook返回的购物车ID做base64编码都不符合格式要求，因此触发Invalid global id报错。
• 正确的传参方式有两种：直接传入完整未编码的gid格式ID，或者传入对完整gid做base64编码后的字符串均可。

2. 能否查询网页端普通访客的购物车数据 #

默认不能直接查询：

• Shopify的网页端默认主题（包括Online Store 2.0及更早版本）使用的是核心购物车体系，关联的是Admin API维度的购物车ID，和Storefront API的购物车是完全隔离的两套数据体系，没有直接的互通映射。
• 只有当你将店铺前端的加购、购物车操作逻辑全部改造为调用Storefront API实现时，生成的购物车数据才能通过Storefront API查询。

3. Storefront体系购物车ID的获取方式 #

• 新购物车场景：直接调用Storefront API的cartCreate mutation创建购物车，接口返回结果中的cart.id就是符合要求的Storefront购物车ID，你可以将该ID存储在用户端cookie或本地存储中，后续查询、修改购物车直接使用该ID即可。
• 存量网页端购物车关联场景：没有官方的ID转换接口，需要手动做数据迁移：先读取网页端原有购物车的所有商品、属性信息，再调用cartCreate接口将这些信息同步写入Storefront体系的新购物车，获取对应ID后替换原有购物车标识即可。
• 注意：webhook返回的是Admin API维度的购物车ID，和Storefront ID无对应转换规则，不要尝试自行编码转换。

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