Redis 与缓存 / 系统课时
实现实时排行榜
实现实时排行榜
本课将把 Sorted Set 命令组合成实时排行榜:写入积分、查询个人名次、读取前 N 名,并处理同分成员。完成后,你将得到一套适用于活动榜、游戏榜和热度榜的最小实现流程。
学习目标
- 设计排行榜键和积分更新流程
- 查询个人名次与榜单分页数据
- 区分唯一顺序与共享并列名次
设计排行榜键
排行榜通常按业务和周期拆键,例如 rank:game:season:2026-07。成员保存稳定用户 ID,分数保存积分;昵称、头像等展示资料应放在数据库或 Hash 中,避免资料变化产生重复成员。
周期榜应在结算后设置 TTL,长期榜则需要归档策略。不要把所有赛季写进一个集合后再依赖成员前缀过滤,因为 Sorted Set 不能按成员前缀高效分页。

更新积分并查询榜单
下面创建赛季榜,并用 Lua 原子完成 alice 加分和名次查询,避免两条命令之间插入其他更新。随后读取前三名,并计算 bob 的共享并列名次。
redis-cli DEL demo:rank:{season-0709} >/dev/null
redis-cli ZADD demo:rank:{season-0709} 100 alice 120 bob 120 carol 90 dave >/dev/null
echo "atomic update:"
redis-cli --raw EVAL "
local score = redis.call('ZINCRBY', KEYS[1], ARGV[1], ARGV[2])
local rank = redis.call('ZREVRANK', KEYS[1], ARGV[2])
return {score, rank}
" 1 demo:rank:{season-0709} 30 alice
echo "top 3:"
redis-cli --raw ZREVRANGE demo:rank:{season-0709} 0 2 WITHSCORES
score=$(redis-cli --raw ZSCORE demo:rank:{season-0709} bob)
higher=$(redis-cli --raw ZCOUNT demo:rank:{season-0709} "($score" +inf)
echo "bob shared rank:"
echo $((higher + 1))预期输出:
atomic update:
130
0
top 3:
alice
130
carol
120
bob
120
bob shared rank:
2ZREVRANK 从 0 开始,页面显示时通常加 1。同分成员仍有确定顺序;反向排名中,同分成员按成员字符串的反字典序排列,因此 carol 位于 bob 之前。
处理共享并列名次
业务若要求两个 120 分用户都显示第 2 名,应先取得成员分数,再用 ZCOUNT key (score +inf 统计严格高于该分数的人数,最后加 1。
这种算法得到竞赛排名:130 分为第 1 名,两个 120 分成员都为第 2 名,下一名是第 4 名。若产品需要稠密排名,还要统计不同分数档位,通常应预计算或维护辅助结构。
分页与一致性边界
榜单分页可使用 ZREVRANGE key start stop WITHSCORES。超大榜单的深分页仍需跳过前面的成员,应限制可查看页数,或基于分数与成员设计游标。
Lua 只能保证脚本内 Redis 操作原子执行。积分消息重试仍可能重复加分,因此业务必须使用事件 ID 做幂等控制。分数使用双精度浮点数,超大整数积分应避免超过精确整数范围。