Redis ZRANGE 怎样按分数和字典序分页

Redis 的 sorted set 分页，关键不是把 offset 换成另一个数字，而是先固定“这一页最后一条记录”的排序边界。ZRANGE 默认按 rank 取值；使用 BYSCORE 后，范围按分数解释，分数相同的 member 仍按字典序排列。实际项目里通常保存 lastScore 和 lastMember，下一页从上一次边界之后继续取。

官方文档：https://redis.io/docs/latest/commands/zrange/

如果允许相同 score 的记录在页边界处分组处理，可以用一个分数游标完成分页；如果要求同分记录也不能重复或遗漏，就必须把 member 的字典序纳入游标，或者建立专门的同分索引。下面把这几个边界拆开。

先把 score 和 member 的排序关系固定下来

sorted set 的每个 member 都有一个 score。Redis 先按 score 从小到大排列；score 相同的时候，再按 member 的字典序排列。这个规则正是“分数优先、同分用字典序打破平局”的基础。

ZRANGE 在 Redis 6.2 之后可以通过 BYSCORE、BYLEX 和 LIMIT 表达不同的范围查询。BYSCORE 的两个边界解释为分数，LIMIT offset count 只在范围查询中生效；BYLEX 则把边界解释为 member 的字典序。

# 建立一个有重复 score 的有序集合，观察同分 member 的排序关系
redis-cli ZADD feed 100 "post:zeta" 100 "post:alpha" 101 "post:beta"

# 按 score 查询；同为 100 的 member 会继续按字典序排列
redis-cli ZRANGE feed 100 100 BYSCORE WITHSCORES

示例中的 post:alpha 和 post:zeta 具有相同分数，因此它们的相对顺序不是写入先后，而是 member 的字节序。分页游标至少要知道最后一条记录的 score；当同分记录可能被拆到不同页面时，还要记录最后一个 member。

用 BYSCORE 做普通游标分页

最简单的场景是按分数递增取一段数据，并且业务允许一页结束在同分组中间。第一页可以从负无穷取到正无穷，下一页把上一页最后一条记录的 score 作为排他下界：

# 第一页：取分数范围内的 20 条，示例中 offset 从 0 开始
redis-cli ZRANGE feed -inf +inf BYSCORE LIMIT 0 20 WITHSCORES

# 假设上一页最后一条 score 是 100；左括号表示不包含 100
# 这样不会因为重复包含边界记录而产生重复
redis-cli ZRANGE feed "(100" +inf BYSCORE LIMIT 0 20 WITHSCORES

分数边界使用 (100 而不是 100，是为了排除已经返回的分数。这个写法适合 score 基本唯一、或者业务允许同分记录由上层另行处理的列表。不要把 LIMIT 100000 20 当成长列表的稳定游标：offset 越大，Redis 仍然需要先跳过前面的匹配项，写入和删除还会让页之间发生位移。

反向查询时使用 REV，但游标方向也要一起改变：上一页记录的 score 变成排他上界，而不是继续使用递增查询的下界。正向和反向不要混用同一套边界含义。

同分记录跨页时，怎样保住游标边界

真正容易出错的是同分数据。假设第一页最后一条记录的 score 是 100，但 score 为 100 的记录还有很多。直接查询 (100 会把剩余同分记录全部跳过；如果改成包含 100，又会把第一页已经返回的记录重新取回来。

BYLEX 可以解决同分集合内部的字典序范围，但它有一个硬条件：集合成员必须使用相同的 score。不能把一个同时存在 99、100、101 分的 sorted set 直接当成通用字典序索引来查；Redis 官方文档明确说明，不同 score 下使用 BYLEX 的返回结果是不确定的。

# 为 score=100 的同分成员维护独立字典序索引，索引内统一使用 0 分
redis-cli ZADD feed:score:100 0 "post:alpha" 0 "post:gamma" 0 "post:zeta"

# 上一页最后一个同分 member 是 post:gamma；排除它，继续取后面的字典序成员
redis-cli ZRANGE feed:score:100 "(post:gamma" + BYLEX LIMIT 0 20

工程上可以把游标写成 {"score":100,"member":"post:gamma"}。服务端先判断同分辅助索引是否还有更大的 member；没有时，再把 score 推进到下一个分数。这样 score 和 member 两个维度都变成排他边界，避免重复和遗漏。代价是写入、删除和分数修改都要同步维护辅助索引。

怎样选择分页策略

如果列表会频繁插入，优先使用游标而不是深 offset；如果 score 会被频繁更新，还要明确“更新后从旧位置继续”还是“按新位置重新出现”。这不是 ZRANGE 参数能替你决定的业务规则，接口应把游标语义写进文档，并对重复、遗漏和排序方向做边界测试。

常见问题

ZRANGE BYLEX 能和 BYSCORE 一起使用吗？

不能把它们当成两个独立过滤器叠加。一次查询选择一种范围解释；需要“先 score、同分再 member”时，应使用 score 游标配合同分 BYLEX 索引，或重新设计可比较的复合排序键。

为什么不直接保存 offset？

offset 只代表当前集合的相对位置，集合中间发生插入或删除后，下一页的相对位置会改变。游标保存排序值，通常比保存页码和 offset 更能抵抗这种漂移。

总结一下：普通场景从排他 score 开始；严格场景保存 score + member，并为同分数据准备满足 BYLEX 同分条件的索引。先确定排序边界，再决定命令写法，分页才不会被“同分记录刚好跨页”打乱。