Storefront API 的 availableForSale 与实际库存不符
现象#
商品实际有货,API 返回 availableForSale: false,前台显示售罄。
原因#
- 商品未发布到当前销售渠道
- 当前市场/国家不支持该商品(Markets 目录限制)
- 库存所在地点未对该渠道供货
quantityAvailable为 0 但允许超卖设置未生效
处理步骤#
- 查
product.publishedAt与渠道发布状态 - 用
@inContext(country:)切换国家对比结果 - 后台检查库存地点与「继续销售」设置
- 确认查询的是
variant.availableForSale而非缓存值
验收标准#
API 返回的可售状态与前台展示、后台库存三者一致,切换市场结果正确。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。