Redis 与缓存 / 系统课时

原子增加成员分数

原子增加成员分数

本课解决排行榜积分、内容热度和动态权重在并发场景下如何安全累加。完成后,你可以使用 ZINCRBY 在单条命令中更新分数,并理解负增量、浮点精度和业务幂等的边界。

学习目标

  • 使用 ZINCRBY 原子增加或减少成员分数。
  • 根据命令返回的新分数验证结果。
  • 区分单命令原子性与完整业务流程原子性。

ZINCRBY 的规则

ZINCRBY key increment member 将成员分数增加 increment,并返回更新后的分数。成员不存在时按初始分数 0 创建;键不存在时自动创建 Sorted Set。

增量可以是正数、负数或小数。正数适合累计积分和热度,负数适合扣分或衰减。命令只修改指定成员,不会影响其他成员。

主示例:加分、扣分与新增成员

bash
redis-cli --raw DEL demo:zset:score:0706 >/dev/null
redis-cli --raw ZADD demo:zset:score:0706 100 alice 80 bob
redis-cli --raw ZINCRBY demo:zset:score:0706 25 alice
redis-cli --raw ZINCRBY demo:zset:score:0706 -10 bob
redis-cli --raw ZINCRBY demo:zset:score:0706 5 carol
redis-cli --raw ZREVRANGE demo:zset:score:0706 0 -1 WITHSCORES

预期输出

text
2
125
70
5
alice
125
bob
70
carol
5

ZINCRBY 已返回新分数,通常不必再执行 ZSCORE。多个客户端同时给同一成员加分时,Redis 会逐条完整执行命令,不会出现应用层“先读后写”导致的丢失更新。

原子性与业务一致性

单条 ZINCRBY 是原子的,但“加分后写流水”“加分后判断升级”等多命令流程不会自动成为一个整体。若这些步骤必须同时完成,可使用 Lua 脚本;若还涉及数据库或消息系统,则需要幂等键、补偿或事务消息等业务设计。

重复消费同一事件会重复加分。生产系统应使用稳定事件 ID 去重,必要时通过 Lua 同时完成去重检查和 ZINCRBY,不能只依赖消息只投递一次。

精度边界

Sorted Set 分数使用双精度浮点数。整数在绝对值不超过 2532^{53} 时可精确表示;金额应转换为最小货币单位的整数,严格小数计算或超大序列号不应直接依赖普通浮点分数。

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

目录与阅读设置

阅读设置

17

记录一个想法

原子增加成员分数

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

登录哪都通