Redis ZREVRANK WITHSCORE 怎么同时取排名和分数：并列名次与缺失成员判断

做周榜接口时，前端通常同时需要“第几名”和“当前分数”。如果先跑一次 ZREVRANK，再跑一次 Z score，代码会多一次往返，还可能在两次读取之间看到不同数据。Redis 的 ZREVRANK key member WITHSCORE 可以一次返回降序排名和分数；但成员不存在时仍然是空结果，并列分数也不会共享同一个名次。

把返回值当成“排名、分数”二元结果处理，并用 nil 单独表示成员缺失，就能同时覆盖正常排名、并列分数和查无此人的场景。

ZREVRANK 的返回值先用一组固定数据看清

先建立一个小型周榜。这里的分数只用于演示，不代表业务规则：

redis-cli DEL leaderboard:weekly
redis-cli ZADD leaderboard:weekly 98 alice 98 bob 91 carol 76 dave
redis-cli ZREVRANGE leaderboard:weekly 0 -1 WITHSCORES
# 1) "alice"
# 2) "98"
# 3) "bob"
# 4) "98"
# 5) "carol"
# 6) "91"
# 7) "dave"
# 8) "76"
redis-cli ZREVRANK leaderboard:weekly alice WITHSCORE
# 1) (integer) 0
# 2) "98"

alice 返回的组合结果可以记为 0 / 98：排名是 0，而不是人类习惯的第 1 名。接口给用户展示时可以加 1，但内部比较和分页仍建议保留 Redis 的 0-based 下标。

并列分数为什么仍然是两个不同排名

把 bob 也设为 98 后，两个成员的分数相同，但有序集合必须保持确定顺序。Redis 会用成员的字典序作为同分时的排序依据，所以 alice 在 bob 前面，两个名次分别是 0 和 1。

redis-cli ZREVRANK leaderboard:weekly bob WITHSCORE
# 1) (integer) 1
# 2) "98"

最终的并列结果可以记为 0 / 1：这也是排行榜接口常见的坑。如果产品要求“并列第一”，就不能直接把 Redis rank 当作名次规则，需要在业务层根据相同分数重新计算展示名次；如果产品要求稳定排序，直接使用 Redis 返回的 rank 更合适。

缺失成员要用 nil 分支处理

查询不存在的成员时，Redis 返回 nil；key 不存在时结果也一样。不要把返回的空值转换成 0，否则“榜首”和“没上榜”会被业务代码混在一起。

redis-cli ZREVRANK leaderboard:weekly erin WITHSCORE
(nil)

redis-cli ZREVRANK leaderboard:missing alice WITHSCORE
(nil)

在客户端里，建议把结果建模为可选值：有结果时读取 rank 和 score，没有结果时返回“未上榜”状态。若还要区分“key 不存在”和“成员不存在”，可以先用 EXISTS 做一次额外判断，但这会增加一次读取，是否值得要看接口是否真的需要区分。

把 ZREVRANK 接进榜单接口时的最小检查

如果只需要排名，省略 WITHSCORE 可以减少返回字段；如果页面马上要展示分数，则保留它更省一次命令往返。不要把 ZREVRANGE 全量拉回应用层再查排名，那会让请求成本随着榜单长度增长。

相关问题

ZREVRANK 的排名是从 0 还是从 1 开始？

Redis 从 0 开始。展示“第 1 名”时在非空 rank 上加 1，空结果不要参与加法。

WITHSCORE 会改变 ZREVRANK 的排序吗？

不会。它只增加分数返回值，排序仍按分数降序和同分时的成员字典序决定。

为什么不存在成员时不能当成排名 0？

因为排名 0 是真实榜首，Redis 用 nil 表示没有匹配成员；客户端应保留这个可区分状态。

小结

ZREVRANK WITHSCORE 适合读取“某个成员在降序榜单中的位置和分数”。记住三个边界：排名是 0-based，同分成员仍按稳定顺序占不同位置，不存在成员返回 nil。接口先把这三类结果分开，后面的展示规则才不会互相污染。