ZAdd默认升序存储,排行榜需降序展示,故应使用ZRevRange而非ZRange;score须为float64(如100.0),member唯一且重复会覆盖;同分排序需用复合score或Lua原子操作。

为什么 zadd 顺序和排行榜展示不一致?
Go-Redis 的 ZAdd 默认按 score 升序存储,但排行榜通常要降序(分数高排前面)。直接用 ZRange 拿到的是 score 从小到大的结果,容易误以为数据写错了。
- 正确做法是改用
ZRevRange获取降序结果,或在ZRange中传入redis.ZRangeWithScores+redis.ZRangeBy{Min: "-inf", Max: "+inf", Offset: 0, Count: -1}后手动反转 - 注意:score 必须是 float64 类型,整数如
100要写成100.0,否则ZAdd会静默失败(无 panic,但数据不入库) - member 必须是唯一字符串;重复 member 会更新 score,不是新增——这点常被当成“插入失败”排查半天
怎么安全地实现「用户得分更新+排名查询」原子操作?
单靠 ZAdd + ZRank 无法避免并发时 rank 查出来是旧值。比如 A 用户刚加了 10 分,还没来得及查 rank,B 用户就查了——看到的还是旧排名。
- 用 Lua 脚本封装:把
ZAdd和ZRevRank(注意是 Rev 版本)打包进一个脚本,通过Eval执行,保证原子性 - 示例脚本:
redis.call("ZADD", KEYS[1], ARGV[1], ARGV[2])\nreturn redis.call("ZREVRANK", KEYS[1], ARGV[2]) + 1(+1 是因为 rank 从 0 开始) - Go 调用:
client.Eval(ctx, script, []string{"leaderboard"}, scoreStr, userID).Result(),其中script是上面那段 Lua
如何分页查前 100 名,同时避免拉全量?
ZRevRange 支持 offset/limit,但容易误用成 ZRange(升序)或漏传 redis.ZRangeWithScores 导致拿不到分数。
- 正确调用:
client.ZRevRangeWithScores(ctx, "leaderboard", 0, 99).Val()—— 第二、三参数是 start/end 索引(含),0~99 就是前 100 名 - 如果想查第 101~200 名,用
100, 199,不是101, 200(索引从 0 开始) - 慎用
ZCard做总数判断再分页:当榜单超大(百万级)时,ZCard是 O(1),但ZRevRange是 O(log(N)+M),M 是返回数量,实际影响不大;真正要防的是前端传非法 offset(如负数或超大值),需在 Go 层校验
排行榜缓存失效后怎么平滑重建?
直接删 key 再批量 ZAdd 会导致窗口期数据丢失或错乱。尤其当业务方依赖实时 rank 时,重建期间 ZRank 可能返回 nil。
立即学习“go语言免费学习笔记(深入)”;
- 不要用
DEL,改用RENAME:先建新 key(如leaderboard_v2),全量写入,再RENAME leaderboard_v2 leaderboard—— 原子切换 - Go 里用
client.Rename(ctx, "leaderboard_v2", "leaderboard").Err(),失败则回滚新 key - 重建期间,老 key 仍可读,新 key 写完才切,无空窗;但要注意 client 连接池里可能有旧连接残留,建议配合 TTL 控制(比如新 key 设 1 小时 TTL,切完立刻
EXPIRE掉)
Redis 有序集合本身不支持“分数相同则按插入时间排序”,如果业务要求同分时按最新更新优先,得在 score 上做手脚——比如用 score * 1e6 + timestamp 当复合 score,但要注意 float64 精度最多 15~16 位,timestamp 用秒级足够,毫秒级就要小心截断。


















