Storefront API 商品变体超过 250 个怎么取全

现象#

查询 variants(first: 250) 只拿到 250 个，商品实际有 600 个变体。

原因#

• GraphQL 连接默认单页上限 250
• 没有处理 pageInfo.hasNextPage 与 endCursor
• 用 first: 1000 被服务端截断但未报错

处理步骤#

1. 按 pageInfo 循环翻页，直到 hasNextPage 为 false
2. 每页取 100-250，控制单次成本
3. 变体极多时改用 productVariants 顶层查询按商品过滤
4. 把结果缓存，避免每次渲染都翻页

验收标准#

能取到全部变体，数量与后台一致，翻页过程无重复或遗漏。