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
5ZINCRBY 已返回新分数,通常不必再执行 ZSCORE。多个客户端同时给同一成员加分时,Redis 会逐条完整执行命令,不会出现应用层“先读后写”导致的丢失更新。
原子性与业务一致性
单条 ZINCRBY 是原子的,但“加分后写流水”“加分后判断升级”等多命令流程不会自动成为一个整体。若这些步骤必须同时完成,可使用 Lua 脚本;若还涉及数据库或消息系统,则需要幂等键、补偿或事务消息等业务设计。
重复消费同一事件会重复加分。生产系统应使用稳定事件 ID 去重,必要时通过 Lua 同时完成去重检查和 ZINCRBY,不能只依赖消息只投递一次。
精度边界
Sorted Set 分数使用双精度浮点数。整数在绝对值不超过 时可精确表示;金额应转换为最小货币单位的整数,严格小数计算或超大序列号不应直接依赖普通浮点分数。
按自己的节奏,确认真正理解。