Shopify Hydrogen cartCreate 失败怎么办

现象#

Hydrogen/cartCreate mutation 返回错误或 cart 为空，加购按钮无响应。本地 mock 正常，连真实店铺失败。有时是 buyer identity 或市场头未传。

原因#

cartCreate 需要有效 Storefront 令牌、正确 API 版本，以及（多市场时）Country/Language 头。变体不可售、库存策略或应用锁购物车也会导致创建失败。把 Admin GID 当成 Storefront 可用 ID 会直接报错。

步骤#

1. 在 GraphiQL（Storefront）最小调用 cartCreate 只带一个已知可售 merchandiseId。
2. 确认 merchandiseId 为 gid://shopify/ProductVariant/...。
3. 多市场时加上与买家匹配的上下文头。
4. 检查店铺是否启用了头无渠道与购买选项。
5. 对照 Cart API 字段名（随版本变更）。
6. 捕获 userErrors 全文，不要只判断 HTTP 200。

验收#

测试变体可创建购物车并 cartLinesAdd；错误路径能展示可读原因。