Redis ZRANK 与 ZREVRANK 怎样判断成员位置

Redis 有序集合判断成员位置时，先看你要的是哪一种顺序：ZRANK 按 score 从小到大排名，ZREVRANK 按 score 从大到小排名。两条命令返回的都是从 0 开始的索引，所以第一名或最低分成员的返回值可能是 0，不能把它当成“没有找到”。

官方地址：https://redis.io/

记忆方法：正向排名用 ZRANK，倒序排名用 ZREVRANK；成员不存在时返回空结果，成员在第一位时返回 0。

先准备一组能看出方向的数据

下面用一个排行榜保存三个成员。分数越大，通常越靠前；但 Redis 的有序集合本身只保存 score 与 member 的排序关系，最终采用升序还是降序由读取命令决定。

# 写入三个成员；分数相同的成员还会按 member 的字典序处理
redis-cli ZADD leaderboard 80 "alice" 95 "bob" 70 "carol"

# 按升序查看成员，确认底层有序集合中的排列
redis-cli ZRANGE leaderboard 0 -1 WITHSCORES

这组数据的升序顺序是 carol(70)、alice(80)、bob(95)。如果业务把最高分称为第一名，展示时就不应该直接把 ZRANK 的结果当作名次。

ZRANK：按分数升序返回 0-based 位置

ZRANK key member 返回成员在升序序列中的位置。对上面的数据，最低分 carol 的位置是 0，alice 是 1，最高分 bob 是 2。

# carol 的分数最低，所以升序位置是 0
redis-cli ZRANK leaderboard carol

# bob 的分数最高，但在升序序列中位置是 2
redis-cli ZRANK leaderboard bob

# 需要分数时可以同时请求 WITHSCORE
redis-cli ZRANK leaderboard bob WITHSCORE

返回值是位置，不是分数。若接口要输出“从 1 开始的名次”，可以在确认成员存在后计算 rank + 1；不要在 Redis 命令层面把 0 改成空值，否则会丢失第一位成员。

ZREVRANK：按分数降序返回 0-based 位置

ZREVRANK key member 把排序方向反过来。此时最高分 bob 的位置为 0，alice 为 1，carol 为 2。它更适合“分数越高名次越靠前”的排行榜。

# bob 的分数最高，所以倒序位置是 0
redis-cli ZREVRANK leaderboard bob

# carol 的分数最低，所以倒序位置是 2
redis-cli ZREVRANK leaderboard carol

# 同时读取倒序位置和 score，避免再次查询成员分数
redis-cli ZREVRANK leaderboard alice WITHSCORE

在 Redis 当前命令文档中，ZRANK 和 ZREVRANK 的单成员查询复杂度都是 O(log(N))。如果页面还要展示整个榜单，排名查询与列表读取应按接口需要组合，不要为每个成员重复发起不必要的请求。

成员不存在时，怎样避免把空结果当成位置 0

查询一个不在有序集合中的成员时，Redis 返回空结果。使用 redis-cli 观察时通常看起来像空行；在客户端库里通常对应 nil、null 或可判定的空响应。它和合法位置 0 完全不同。

# nobody 不在集合中；返回空结果，不是 0
redis-cli ZRANK leaderboard nobody

# 删除测试集合，空 key 上查询也会得到空结果
redis-cli DEL leaderboard
redis-cli ZREVRANK leaderboard bob

业务代码应先判断“是否有返回值”，再把位置转换成展示名次。若客户端把返回值统一转换成整数，必须确认它是否会把 nil 自动转成 0；一旦存在这种转换，就可能把“不存在成员”误报为“第一名”。

排名命令速查与常见误区

最后记住两个边界：score 相同的成员仍然需要按 member 的排序规则稳定处理；而“第几名”通常是业务语言，Redis 返回的是 0-based 位置。选择命令时先确定排序方向，再设计空值和名次转换逻辑。

相关问题

ZRANK 返回 0 是不是查询失败？

不是。返回 0 表示成员确实存在，并位于当前排序方向的第一位；查询失败或成员不存在要看客户端的空结果或错误信息。

怎样拿到从 1 开始的排行榜名次？

先判断返回值不是空，再对 0-based 位置加 1。不要直接把空值转换成整数后再加 1。