Redis Sorted Set 怎么按字典序分页

Redis Sorted Set 要按字典序分页，先把参与字典序查询的成员设为同一个 score，再使用 ZRANGE key min max BYLEX LIMIT offset count。第一页从 - 到 + 读取；下一页把上一页最后一个成员作为排他起点，例如 (bob，这样不会重复返回游标成员。

官方地址：https://redis.io/docs/latest/commands/zrange/

这是一种按成员值推进的游标分页，不是按第几页计算 offset。它适合“用户名、编码、标签”等同分值成员的范围读取；如果排序主键是分数，应改用 BYSCORE 或普通 rank 查询。

先固定同一 score，明确字典序的比较范围

Sorted Set 的主排序规则仍然是 score。只有 score 完全相同时，Redis 才按成员字符串比较字典序；官方文档说明这种比较基于二进制 memcmp，不是中文拼音或当前语言环境的排序。因此，适合字典序索引的写入模型通常是所有成员都使用 0，把业务数据放在成员或另一个 Hash 中。

# 统一 score，后续 BYLEX 才只在这一组成员中按字节序比较
ZADD user:name:index 0 "alice" 0 "alina" 0 "bob" 0 "carol" 0 "dave"

# 查看同分值成员的自然字典序
ZRANGE user:name:index 0 -1

如果同一个 Sorted Set 里混入不同 score，结果会先按 score 排序，再在相同 score 内比较成员；此时“整个集合按字典序分页”的前提已经不成立。大小写、数字和 UTF-8 字节序也要在接口约定中写清楚，不能把它当作数据库的自然语言排序。

用 ZRANGE BYLEX 读取第一页

Redis 6.2 及以上优先使用 ZRANGE 的 BYLEX 选项。字典序范围的最小边界用 -，最大边界用 +；LIMIT 0 3 表示在匹配范围内跳过 0 个成员，最多返回 3 个。

# 首页覆盖整个字典序范围，页面大小为 3
ZRANGE user:name:index - + BYLEX LIMIT 0 3

# 预期返回：alice、alina、bob

这里的 LIMIT 不是“第 1 页”的永久标识，而是当前范围内的局部截取。第一页可以使用 offset 0，但深分页不应把页码乘以 pageSize 继续累加，因为前面成员的新增或删除会让 offset 失去稳定锚点。

旧版本代码中常见的 ZRANGEBYLEX key min max LIMIT offset count 仍可识别，但从 Redis 6.2 起被标记为 deprecated；新代码使用 ZRANGE ... BYLEX，迁移时只需要保持边界和 LIMIT 语义一致。

用排他游标读取下一页

服务端返回本页最后一个成员，例如第一页最后一项是 bob，同时把它放入下一页游标。下一次查询把左边界写成 (bob，左括号表示不包含该成员：

# cursor 是上一页最后一个成员，使用左括号表示排除它
ZRANGE user:name:index "(bob" + BYLEX LIMIT 0 3

# 预期返回：carol、dave；不会再次返回 bob

游标分页的最小实现只需要保存 lastMember、pageSize 和必要的过滤条件。下一页返回数量小于 pageSize 时可以标记为末页；返回空数组也说明当前游标后面没有成员。游标应进行编码并校验长度，避免把任意原始边界直接拼接进命令字符串。

处理边界、兼容命令与并发变化

实现时可以按下面的清单收口：

• 先确认查询集合的成员是否全部使用同一 score；不满足时不要声称是纯字典序。
• 第一页使用 - + BYLEX LIMIT 0 size，后续页固定使用 (lastMember + BYLEX LIMIT 0 size。
• 成员是二进制字典序，中文、大小写和数字的顺序要以接口测试样例定义，不要按拼音猜测。
• 如果分页期间允许新增数据，游标之后新增的成员可能出现在后续页；如果需要严格快照，应先生成版本化索引或不可变分页快照。

性能上，官方命令复杂度为 O(log(N)+M)，其中 N 是集合成员数，M 是返回数量；使用固定 pageSize 时，游标边界比不断增大的 offset 更适合深分页。最后，客户端应把边界参数作为独立参数传递，使用 Redis 客户端的命令参数接口，不要自行拼接未校验的请求文本。

常见问题

为什么查出来不是中文拼音顺序？因为 BYLEX 比较的是成员的二进制字节序，不提供拼音、大小写折叠或 locale 排序。需要拼音顺序时，应在写入侧生成可排序的规范化成员，并保留原始显示值。

能不能把 page=10 转换成 LIMIT 90 10？不建议。offset 越大，分页越容易受到前序数据变化影响；让客户端携带上一页最后成员，使用排他游标更稳定。

什么时候应使用 BYSCORE？当业务结果按时间、权重或优先级排序时使用 BYSCORE；BYLEX 只解决同分值成员的字典序范围读取。