Redis ZSet天然适合实现排行榜，因其按score自动排序、支持范围查询与排名获取；Java中通过Jedis等客户端调用ZADD、ZREVRANGE、ZREVRANK等命令即可高效实现。
Redis 的 ZSet（有序集合）天然适合实现排行榜，因为它的元素按 score 排序，支持范围查询、排名获取、分数更新等操作，Java 中通过 Redis 客户端（如 Jedis 或 Lettuce）调用对应命令即可高效实现。
核心原理：ZSet 如何支撑排行榜
ZSet 每个成员（member）关联一个 double 类型的 score，Redis 自动按 score 升序排列（score 相同时按 member 字典序）。排行榜通常需要「分数越高名次越靠前」，所以实际使用时可将原始分数取负，或在查询时用 ZREVRANGE（逆序）代替 ZRANGE。
关键能力包括：
-
添加/更新用户得分：用
ZADD key score member，重复 member 会自动更新 score -
获取 Top N 用户：用
ZREVRANGE key 0 N-1 WITHSCORES（逆序取前 N 名） -
查询用户排名：用
ZREVRANK key member（返回从 0 开始的降序排名） -
查询用户分数：用
ZSCORE key member -
删除过期或无效用户：用
ZREM key member或ZREMRANGEBYSCORE
Java 示例（基于 Jedis）
以下是一个轻量级排行榜工具类片段：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
立即学习“Java免费学习笔记（深入）”；
public class LeaderboardService {
private final Jedis jedis;
public LeaderboardService(Jedis jedis) {
this.jedis = jedis;
}
// 上报/更新用户分数（分数越高，排名越前）
public void updateScore(String userId, double score) {
jedis.zadd("leaderboard:weekly", score, userId);
}
// 获取本周排行榜前 10（含分数）
public List<Tuple> getTop10() {
return jedis.zrevrangeWithScores("leaderboard:weekly", 0, 9);
}
// 查询某用户当前排名（从 1 开始）
public Long getUserRank(String userId) {
Long rank = jedis.zrevrank("leaderboard:weekly", userId);
return rank != null ? rank + 1 : null; // 转为 1-based
}
// 查询某用户分数
public Double getUserScore(String userId) {
String scoreStr = jedis.zscore("leaderboard:weekly", userId);
return scoreStr != null ? Double.parseDouble(scoreStr) : null;
}
// 清理过期榜单（例如每周重置）
public void resetWeekly() {
jedis.del("leaderboard:weekly");
}
}
实用优化建议
真实场景中需注意几个细节：
-
Key 设计带时间维度：如
leaderboard:20240520或leaderboard:monthly:202405，避免跨周期干扰 - 分数精度处理：若原始分是整数但需支持并列，可将时间戳（毫秒）作为低 13 位补足，保证唯一性且不影响排序主逻辑
-
大榜单分页慎用 ZRANGE：当用户量极大（如百万级），
ZREVRANGE key 100000 100010仍高效，因 ZSet 底层是跳表，O(log N + M) -
原子性保障：如「用户得分+1 并更新排名」，可用 Lua 脚本封装
ZINCRBY+ZREVRANK，避免竞态
常见问题提醒
初学者容易踩的坑：
- 混淆 ZRANK 和 ZREVRANK：前者是升序排名（score 小→名次高），后者才是降序（score 大→名次高），排行榜几乎总用 ZREVRANK
-
没处理 member 不存在的情况：
ZREVRANK返回 nil，Java 中对应 null，需判空，否则 NPE -
未设置过期时间：用
EXPIRE key 604800给周榜设 7 天过期，避免内存无限增长 - 误用 String 存分数再自己排序：完全失去 ZSet 的 O(log N) 查询优势，也难保证一致性
