Redis 与缓存 / 系统课时

实现实时排行榜

实现实时排行榜

本课将把 Sorted Set 命令组合成实时排行榜:写入积分、查询个人名次、读取前 N 名,并处理同分成员。完成后,你将得到一套适用于活动榜、游戏榜和热度榜的最小实现流程。

学习目标

  • 设计排行榜键和积分更新流程
  • 查询个人名次与榜单分页数据
  • 区分唯一顺序与共享并列名次

设计排行榜键

排行榜通常按业务和周期拆键,例如 rank:game:season:2026-07。成员保存稳定用户 ID,分数保存积分;昵称、头像等展示资料应放在数据库或 Hash 中,避免资料变化产生重复成员。

周期榜应在结算后设置 TTL,长期榜则需要归档策略。不要把所有赛季写进一个集合后再依赖成员前缀过滤,因为 Sorted Set 不能按成员前缀高效分页。

实时排行榜读写流程

更新积分并查询榜单

下面创建赛季榜,并用 Lua 原子完成 alice 加分和名次查询,避免两条命令之间插入其他更新。随后读取前三名,并计算 bob 的共享并列名次。

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

预期输出:

text
atomic update:
130
0
top 3:
alice
130
carol
120
bob
120
bob shared rank:
2

ZREVRANK 从 0 开始,页面显示时通常加 1。同分成员仍有确定顺序;反向排名中,同分成员按成员字符串的反字典序排列,因此 carol 位于 bob 之前。

处理共享并列名次

业务若要求两个 120 分用户都显示第 2 名,应先取得成员分数,再用 ZCOUNT key (score +inf 统计严格高于该分数的人数,最后加 1。

这种算法得到竞赛排名:130 分为第 1 名,两个 120 分成员都为第 2 名,下一名是第 4 名。若产品需要稠密排名,还要统计不同分数档位,通常应预计算或维护辅助结构。

分页与一致性边界

榜单分页可使用 ZREVRANGE key start stop WITHSCORES。超大榜单的深分页仍需跳过前面的成员,应限制可查看页数,或基于分数与成员设计游标。

Lua 只能保证脚本内 Redis 操作原子执行。积分消息重试仍可能重复加分,因此业务必须使用事件 ID 做幂等控制。分数使用双精度浮点数,超大整数积分应避免超过精确整数范围。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现实时排行榜

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

登录哪都通