实务专题 · 交付验收

目录导出完成,要证明游标真的走到最后一页

导出第一页不等于导出整个目录。应明确游标推进、重复游标检测及终止证据。行数很多也不能证明授权项目全部导出,尤其当连接器悄悄重复读取同一页时。

适用读者与交付决定

采购CMS及商品目录迁移导出的企业。把本题作为网站供应方的有限验收任务;实际系统证据不能由教学例子替代。

官方依据与解释边界

Shopify GraphQL连接提供hasNextPage及endCursor等分页信息,用于继续请求;响应仍受权限和当前API规则约束。 Shopify: GraphQL pagination · 核对日期:2026年10月16日。

已填写教学例子

合成例子,不是真实客户案例。 列出有限输入、预期结果及反例,不代表已完成真实平台集成。

窄屏可横向滚动表格。

输入/情况检查口径预期结果
page A → cursor c1 → page B terminal两页不同已见终点
c1 followed by c1 again没有推进停止复核
hasNext=true, cursor missing证据不全暂停

怎样执行验收

  1. 导出前记录范围、API版本及获准对象。
  2. 逐页保留数量、下一游标与终止标记,重复或缺失时停止。
  3. 核对去重ID及获准来源数量,说明导出期间的更新边界。

如何解释结果与保留证据

例子检查有限分页日志,不调用API。见到终点只证明日志到达所述末尾,不证明权限开放了所有业务记录。重复、删除与期间变更仍需对账策略。本题是目录可迁移性交付,不是支付收入报告。

适用边界

不是导出器或API完整性认证,不增加付费API、密钥、权限或客户资料访问。

离线复核

把下方两份文件存入同一目录,以Node22.13或更新版本运行。示例不联网、不修改任何账号或网站。 已填输入与预期输出 · 可检查的函数

node decision-check.mjs catalogue-export-cursor-completeness.json