---

title: GraphQL Connection分页：Relay游标与稳定排序

keywords:

• GraphQL
• Connection
• 游标分页
• Relay
• 稳定排序

description: 采用 Relay Connection 规范进行游标分页，保障稳定排序与向前/向后滚动一致性。

categories:

• 文章资讯
• 编程技术

---

GraphQL Connection分页：Relay游标与稳定排序

概览

Connection 模型通过游标与边/节点结构提供稳定的分页语义，适合长列表与滚动加载。

技术参数（已验证）

• 游标：基于稳定排序键生成不可猜的游标，支持 after/before/first/last。
• 边与节点：edges/node/pageInfo 提供上一/下一页指示与边界信息。
• 一致性：排序键唯一且稳定，避免插入/删除造成重复或遗漏。

实战清单

• 选择单调递增或唯一组合键作为排序基础；游标进行签名或编码。
• 返回 pageInfo 完整字段，便于客户端控制滚动。