变更内容
Liquid 和 Storefront GraphQL API 现在将对象数组的分页限制为最多 25,000 项。此变更影响以下方面:
- 对于使用first、last、before和after参数的分页GraphQL查询,当对数组中的第25,000项之后的内容进行分页时,查询现在将返回错误。
- 在Liquid中使用paginate标签时,当对数组中的第25,000项之后的内容进行分页时,将返回最后一个允许的页面。
- 任何源自 Liquid 或 GraphQL 的计数查询,对于包含超过 25,000 个项目的数组,现在将返回最大值为 25,001(表示“超过 25,000”)。
此外:
- 为了与 Storefront GraphQL API 的限制保持一致,Liquid 的最大页面大小已从 50 增加到 250。
Liquid和API用法的文档已更新,以反映这些限制。
重要提示:此更改仅影响Liquid和Storefront GraphQL API。Admin GraphQL API继续支持面向商家的工作流中的更高限制。有关此方面的最近变更日志,请参见此处和此处。
您需要执行的操作
如果您的应用程序、商店前端或 Liquid 主题分页处理的项目超过 25,000 项:
- 在视图中添加筛选条件,以便在分页之前缩小结果范围。例如,按产品类型、价格范围或可用性进行筛选。
- 更新计数处理方式,以应对最大返回值 25,001,并将其替换为人类可读的值,例如“可用产品超过 25,000 件”。

