Redis ZREMRANGEBYRANK 怎样删除有序集合的最低排名成员

如果要从 Redis 有序集合中按排名删除一段成员，直接使用 ZREMRANGEBYRANK key start stop。它按升序 rank 计算范围，rank 从 0 开始，而且 stop 也包含在删除范围内。比如要保留分数最高的 10 名成员，可以删除 0 到 -11 的成员；命令返回实际删除的数量，整个集合被删空后对应的 key 也会消失。

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

先看懂有序集合里的 rank

sorted set 的每个成员都有一个 score。Redis 先按 score 从小到大排列，位置就是 rank：最小 score 的成员是 rank 0，下一项是 rank 1。多个成员分数相同时，Redis 还会按成员值的字典序决定相对位置，所以“最低排名”实际指当前排序中的前段，而不一定等同于某个固定分数。

这也是按排名清理和按分数清理的区别：排名取决于集合当下的整体顺序，成员新增、分数更新后，某个成员的 rank 可能变化；分数范围则直接由数值边界决定。

ZREMRANGEBYRANK 的参数和闭区间

命令的最小形式如下。start 与 stop 都是 rank，两个端点都有效。返回值是被删除的成员数量，而不是删除后的集合大小。

# 按升序 rank 删除从 0 到 2 的三名成员，stop=2 也会被删除
ZREMRANGEBYRANK leaderboard 0 2

# 只删除 rank 5 到 rank 9 的五名成员
ZREMRANGEBYRANK leaderboard 5 9

第一个命令会覆盖 rank 0、1、2；如果误写成 0 3，就会多删一名。生产代码中不要把“最后一个位置”当作开区间来理解，先把期望保留的成员数量换算成明确的 rank 区间。

保留最高 N 名时怎样写

最常见的场景是排行榜只保留最高的 N 名，低分成员需要被清理。因为 rank 0 在最低分一侧，而负数 rank 从最高分一侧倒数，所以保留最高 10 名可以写成：

# 删除最低分一侧直到倒数第 11 名，最终保留最高 10 名
ZREMRANGEBYRANK leaderboard 0 -11

# 查看剩余成员，WITHSCORES 让结果同时带上分数
ZRANGE leaderboard 0 -1 WITHSCORES

这里的 -1 表示最后一个成员，-11 表示倒数第 11 个成员。由于删除区间包含 stop，0 -11 会删掉倒数第 11 个及其之前的所有成员，留下最后 10 个位置。集合不足 11 个成员时，这个范围可能覆盖整个集合，因此应把“保留 N 名”的业务约束和空集合情况一起考虑。

返回数量和删空后的处理

命令返回一个整数。返回 0 表示没有成员落在给定区间内，可能是 start 大于 stop、范围超出集合、key 不存在，或者命令执行前集合已经为空；返回正数才代表确实移除了成员。删除全部成员后，Redis 会删除这个 sorted set key，后续读取会表现为 key 不存在，而不是留下一个空的 sorted set。

# 先读取集合数量，便于把保留策略和当前数据量分开判断
ZCARD leaderboard

# 按排名清理低分成员；返回值是本次实际删除数量
ZREMRANGEBYRANK leaderboard 0 -11

# 需要观察剩余排名时读取成员和分数
ZRANGE leaderboard 0 -1 WITHSCORES

批处理程序应记录返回值，而不要只记录“命令没有报错”。返回 0 和返回正数对应的业务含义不同；如果任务要求集合必须存在，还要在业务层区分“清理后为空”和“原本没有这个 key”。

按排名、分数还是字典序清理

如果业务说的是“只保留最新 100 个排名”，用 rank 更直接；如果说的是“删除 score 小于 60 的成员”，应使用分数命令，不要先读全量成员再自行过滤；如果是相同 score 下按名称清理，才考虑字典序命令。

几个容易写错的边界

• 把 stop 当成开区间：ZREMRANGEBYRANK key 0 9 删除的是 10 个位置，而不是 9 个。
• 混淆最高和最低：升序 rank 的 0 是最低分一侧，想保留高分通常要结合负数 rank。
• 忽略分数相同：相同 score 的成员仍有顺序，按 rank 删除时可能只删掉其中一部分。
• 把返回值当剩余数量：返回值表示删除数量，剩余数量需要另行读取或根据删除前数量计算。
• 假设空 key 仍存在：删完后 key 会被移除，依赖 key 存在性的代码要明确处理这个状态。

相关问题

ZREMRANGEBYRANK 的 rank 是从 0 还是从 1 开始？

从 0 开始，最小 score 的成员是 rank 0；stop 是包含的。

只想删除低于某个分数的成员怎么办？

使用 ZREMRANGEBYSCORE 表达数值区间，不要把分数值当成 rank。

删除后为什么查不到原来的 sorted set key？

当删除范围覆盖全部成员时，Redis 会删除这个 key。这是 sorted set 的正常生命周期，不是读取失败。

记住一条规则：ZREMRANGEBYRANK 面向的是排序位置，rank 从 0 开始且 stop 包含；要保留最高 N 名，就从 rank 0 清理到 -N-1，并用返回数量判断本次是否真的删到了成员。