Redis ZRANGE 怎样按分数和成员稳定读取排行榜

Redis 的排行榜要想读得稳定，先把排序契约写清楚：score 决定主顺序；分数相同的时候，member 按字典序作为 tie-breaker。默认 ZRANGE 从低分到高分，排行榜通常加 REV 读取高分在前；展示分数时再加 WITHSCORES。

如果只是展示固定页，用排名区间最直观；如果要按分数筛选，用 BYSCORE 和 LIMIT；如果要做深分页，不能只保存最后一个分数，还要把同分成员的边界纳入游标。

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

先确定排行榜的排序契约

Redis 有序集合里的每个成员都有一个分数。不同分数按数值排序；分数相同的成员按字典序排序，因此同一组数据的读取顺序是确定的，不取决于 ZADD 的写入先后。REV 会把顺序反过来：高分在前，同分成员也按反向字典序排列。

例如，成员 alice 和 bob 都是 100 分时，正序中 alice 在前；排行榜用 REV 时则是 bob 在前。这就是“成员 tie-breaker”：它能消除同分时的随机感，但它不是业务时间，也不代表谁先写入。

用 ZRANGE 读取带分数的固定页

榜单首页通常先取前 10 名。按排名读取时，下标从 0 开始，并且结束下标是包含的，所以第 1 页可以写成 0 9，第二页写成 10 19。加上 REV 后，下标 0 就代表最高分成员。

# 用 REV 让高分在前，0 到 9 表示首页的 10 个位置
ZRANGE leaderboard 0 9 REV WITHSCORES

# 第二页从第 11 个位置开始；结束下标同样是包含的
ZRANGE leaderboard 10 19 REV WITHSCORES

WITHSCORES 会把成员和分数成对返回，客户端可以把它映射成列表项。这个方案适合后台榜单、运营页或数据变化不太快的分页接口；但如果第一页读取后有新成员插入，原来的第 10 名可能移动到下一页，按排名分页就会出现重复或漏项。

用 BYSCORE 和 LIMIT 读取分数区间

当接口要表达“只看 80 到 100 分”时，用 BYSCORE 比先读整页再在应用层过滤更清楚。正序时第一个边界是低分，第二个边界是高分；用 REV 时参数位置仍要按高分到低分填写。

# 正序读取 80 到 100 分，边界默认包含
ZRANGE leaderboard 80 100 BYSCORE WITHSCORES

# 只取高分到低分中的前 10 条；REV BYSCORE 时先写高分边界
ZRANGE leaderboard 100 80 REV BYSCORE LIMIT 0 10 WITHSCORES

# 排除 80 分，避免与上一段结果重复；左括号表示开区间
ZRANGE leaderboard (80 100 BYSCORE LIMIT 0 10 WITHSCORES

LIMIT offset count 只对 BYSCORE 或 BYLEX 有意义。它会跳过匹配成员后再返回结果；当 offset 很大时，Redis 仍要先遍历被跳过的成员，深分页成本可能接近线性增长。因此 LIMIT 100000 20 不是天然的高效分页。

把成员 tie-breaker 纳入游标设计

只把最后一条记录的分数保存为游标是不够的。假设上一页最后一条是 100, alice，同一分数下还可能有 bob、carol。下一页如果只查询“小于 100 分”，这些同分成员会被整体跳过；如果仍包含 100 分，又可能把 alice 读回来。

稳定游标至少要保存二元组 (lastScore, lastMember)。在高分优先的榜单中，下一页的逻辑是：取分数低于 lastScore 的成员，或者取同分但在当前反向字典序中排在 lastMember 之后的成员。ZRANGE BYSCORE 原生按分数过滤，无法在普通不同分数的排行榜里同时表达任意的成员边界，因此应用层需要处理同分带，或把游标编码到一个明确的复合排序模型中。

如果榜单允许实时变化，还要先定义接口承诺：是允许读者看到轻微漂移，还是要求一次翻页过程近似固定快照。Redis 的排序规则能保证同一时刻的确定性，但不会替应用层冻结数据；成员分数被更新、成员被删除或新成员插入，都可能改变后续页面。

用一条工作流选择分页方案

1. 先写顺序：确认是低分优先还是高分优先，并明确同分成员是否接受 Redis 默认字典序。
2. 再选入口：只展示前几页时使用排名区间；需要分数范围时使用 BYSCORE。
3. 补齐返回值：列表需要展示分数就加 WITHSCORES，并让客户端按成员、分数成对解析。
4. 控制分页深度：避免把很大的排名 offset 直接暴露给接口；深分页优先设计基于边界的查询。
5. 保存复合游标：游标至少包括最后一条的分数和成员，不能只保存 score。
6. 声明一致性边界：写清楚并发更新时允许重复、遗漏还是要求重新开始翻页，避免把 Redis 的排序确定性误认为快照一致性。

常见误区

速查表

总结一下，ZRANGE 的稳定读取来自两层契约：分数定义主顺序，成员定义同分时的确定性顺序。固定榜单页可以使用 REV 加排名区间；分数筛选使用 BYSCORE 加开闭区间和 LIMIT；要做能承受翻页变化的接口，则把最后分数和最后成员一起放入游标，并明确并发写入带来的边界。

相关问答

为什么同分成员顺序看起来和写入顺序不一致？

因为 Redis Sorted Set 在分数相同时按成员字典序排序，写入先后不会成为第二排序键。

排行榜应该用 ZRANGE 还是旧的 ZREVRANGE？

Redis 6.2 起，ZRANGE 的 REV 可以表达反向按排名读取；旧命令仍可能出现在兼容代码里，但新代码应统一检查目标客户端是否支持新参数。

为什么不用一个自增序号解决同分排序？

自增序号可以表达业务需要的先后，但它改变了排序模型，不再是 Redis 默认的 member tie-breaker。选择它之前要确认写入顺序、重放和跨服务生成序号都符合业务要求。