Shopify Storefront API

Storefront API 的 availableForSale 与实际库存不符

现象#

商品实际有货,API 返回 availableForSale: false,前台显示售罄。

原因#

  • 商品未发布到当前销售渠道
  • 当前市场/国家不支持该商品(Markets 目录限制)
  • 库存所在地点未对该渠道供货
  • quantityAvailable 为 0 但允许超卖设置未生效

处理步骤#

  1. 查 product.publishedAt 与渠道发布状态
  2. 用 @inContext(country:) 切换国家对比结果
  3. 后台检查库存地点与「继续销售」设置
  4. 确认查询的是 variant.availableForSale 而非缓存值

验收标准#

API 返回的可售状态与前台展示、后台库存三者一致,切换市场结果正确。

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