Redis 与缓存 / 系统课时

实现排行榜功能

实现排行榜功能

本课使用 Redis Sorted Set 实现积分排行榜。完成后,你可以原子更新用户积分,查询个人名次、Top N 榜单和指定区间,并正确处理分值相同与排名展示问题。

学习目标

  • 使用 Sorted Set 保存成员与积分
  • 完成积分累加、个人排名和区间查询
  • 理解同分排序、排名方向和分页边界

建立排行榜模型

Sorted Set 的 member 保存用户 ID,score 保存积分。写入使用 ZADD,增量更新使用 ZINCRBY,从高到低查询使用 ZREVRANGE,个人位置使用 ZREVRANK。

Sorted Set 排行榜处理流程

运行积分与排名示例

下面的脚本先清空测试榜单,再写入四名用户积分,为用户 u1002 增加 35 分,并输出个人名次与前三名。前置条件是 Redis 可访问且已安装 redis Python 包。

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))

预期输出

text
u1002 新积分:130
u1002 当前名次:2
1 u1003 150
2 u1002 130
3 u1001 120

ZREVRANK 返回从 0 开始的位置,展示给用户时通常加 1。成员不存在时返回空值,不能直接参与加法。

查询区间与分页

Top N 查询的结束下标是包含关系,因此前 10 名使用 0 到 9。页码从 1 开始时,起始下标为 (page - 1) * size,结束下标为 start + size - 1。

按分数筛选可使用 ZRANGEBYSCORE 或对应的倒序命令,适合查询达到奖励线的用户。榜单规模很大时不要一次读取全部成员,应使用固定区间分页。

处理同分与业务排序

score 相同时,Redis 会继续按 member 的字典序确定先后;倒序查询时顺序也会相应反转。这通常不等于业务期望,而且 ZREVRANK 仍会给同分成员不同位置。

若必须支持“先达到分数者优先”,可以设计复合分值,但要评估浮点精度、更新时间和可解释性。更稳妥的做法是接受同分并列,或读取候选区间后由业务层按额外字段排序,并明确采用顺序排名、并列排名还是密集排名。

规划榜单生命周期

周期榜单应把月份、赛季或活动 ID 放入键名,避免清空仍在读取的旧榜。新周期创建新键,旧榜设置保留期并异步归档。积分事件必须幂等,防止消息重试导致重复累加。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现排行榜功能

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通