Redis 与缓存 / 系统课时

使用字段数值增量

使用字段数值增量

本课使用 HINCRBY 和 HINCRBYFLOAT 原子更新 Hash 数值字段。你将能实现计数与指标累加,并理解数字格式、整数溢出、金额精度和跨字段一致性的边界。

学习目标

  • 使用 HINCRBY 原子更新整数字段
  • 使用 HINCRBYFLOAT 更新十进制小数字段
  • 理解单字段原子性与业务一致性的区别

原子增加整数和小数

HINCRBY key field increment 用于 64 位有符号整数,增量可以为负数。HINCRBYFLOAT key field increment 用于十进制小数,结果仍以字符串形式存储。

bash
redis-cli DEL metrics:20260730 >/dev/null
redis-cli HSET metrics:20260730 pageViews 100 revenue 12.5
redis-cli HINCRBY metrics:20260730 pageViews 5
redis-cli HINCRBYFLOAT metrics:20260730 revenue 0.75
redis-cli HMGET metrics:20260730 pageViews revenue

预期输出

text
(integer) 2
(integer) 105
"13.25"
1) "105"
2) "13.25"

两条增量命令都由 Redis 原子执行,不会出现两个客户端同时读取旧值后再写回,导致其中一次更新被覆盖的问题。原子性只覆盖当前命令,不代表多个字段或外部数据库操作自动成为一个整体。

缺失字段与类型错误

字段不存在时,Redis 会把初始值视为 0 后再执行增量;Hash 键不存在时也会自动创建。字段已存在但不是合法数字时,命令返回错误,原值保持不变。

HINCRBY 的结果不能超过 64 位有符号整数范围,接近上限的计数器应设计溢出检查。应用还应限制异常大的增量,避免错误请求一次破坏累计值。

精度与一致性边界

HINCRBYFLOAT 适合统计、比例和允许浮点表示的指标,不适合直接保存要求严格十进制精度的金额。金额通常转换为分、厘等最小货币单位后使用整数累加。

若业务要求“扣减余额并同时增加累计消费”,两条独立增量命令之间仍可能被其他请求观察或打断。此时应使用 Lua 脚本、事务或其他能够一次校验并更新多个字段的机制。

关键账务数据还应持久化到可靠数据库并建立对账流程。Redis 可以承担高频计数或聚合,但不应仅凭单字段原子性替代完整的资金一致性设计。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用字段数值增量

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

登录哪都通