大数跨境

Liquid 和 Storefront GraphQL API 的新分页限制

Liquid 和 Storefront GraphQL API 的新分页限制 Shopify电商独立站
2025-06-17
2
导读:Liquid 和 Storefront GraphQL API 现在将对象数组的分页限制为最多 25,000 条记录。此变更影响以下方面:

变更内容

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 件”。
【声明】内容源于网络
0
0
Shopify电商独立站
1234
内容 7146
粉丝 0
Shopify电商独立站 1234
总阅读87.4k
粉丝0
内容7.1k