Redis 与缓存 / 系统课时
实现排行榜功能
实现排行榜功能
本课使用 Redis Sorted Set 实现积分排行榜。完成后,你可以原子更新用户积分,查询个人名次、Top N 榜单和指定区间,并正确处理分值相同与排名展示问题。
学习目标
- 使用 Sorted Set 保存成员与积分
- 完成积分累加、个人排名和区间查询
- 理解同分排序、排名方向和分页边界
建立排行榜模型
Sorted Set 的 member 保存用户 ID,score 保存积分。写入使用 ZADD,增量更新使用 ZINCRBY,从高到低查询使用 ZREVRANGE,个人位置使用 ZREVRANK。

运行积分与排名示例
下面的脚本先清空测试榜单,再写入四名用户积分,为用户 u1002 增加 35 分,并输出个人名次与前三名。前置条件是 Redis 可访问且已安装 redis Python 包。
import redis
client = redis.Redis(host="localhost", port=6379, decode_responses=True)
key = "prod:rank:points:v1:202607"
client.delete(key)
client.zadd(
key,
{
"u1001": 120,
"u1002": 95,
"u1003": 150,
"u1004": 80,
},
)
new_score = client.zincrby(key, 35, "u1002")
rank_index = client.zrevrank(key, "u1002")
top_three = client.zrevrange(key, 0, 2, withscores=True)
if rank_index is None:
raise RuntimeError("u1002 不在榜单中")
print(f"u1002 新积分:{int(new_score)}")
print(f"u1002 当前名次:{rank_index + 1}")
for index, (user_id, score) in enumerate(top_three, start=1):
print(index, user_id, int(score))预期输出
u1002 新积分:130
u1002 当前名次:2
1 u1003 150
2 u1002 130
3 u1001 120ZREVRANK 返回从 0 开始的位置,展示给用户时通常加 1。成员不存在时返回空值,不能直接参与加法。
查询区间与分页
Top N 查询的结束下标是包含关系,因此前 10 名使用 0 到 9。页码从 1 开始时,起始下标为 (page - 1) * size,结束下标为 start + size - 1。
按分数筛选可使用 ZRANGEBYSCORE 或对应的倒序命令,适合查询达到奖励线的用户。榜单规模很大时不要一次读取全部成员,应使用固定区间分页。
处理同分与业务排序
score 相同时,Redis 会继续按 member 的字典序确定先后;倒序查询时顺序也会相应反转。这通常不等于业务期望,而且 ZREVRANK 仍会给同分成员不同位置。
若必须支持“先达到分数者优先”,可以设计复合分值,但要评估浮点精度、更新时间和可解释性。更稳妥的做法是接受同分并列,或读取候选区间后由业务层按额外字段排序,并明确采用顺序排名、并列排名还是密集排名。
规划榜单生命周期
周期榜单应把月份、赛季或活动 ID 放入键名,避免清空仍在读取的旧榜。新周期创建新键,旧榜设置保留期并异步归档。积分事件必须幂等,防止消息重试导致重复累加。