架构与系统设计 / 系统课时

用 Lua 原子校验并扣减库存

用 Lua 原子校验并扣减库存

本节把“活动是否可售、库存是否足够、扣减库存”放进同一个 Redis Lua 脚本执行,消除先查再减的竞态。库存耗尽后直接返回失败码,让请求在 Redis 层快速结束。

学习目标

  • 解释先查询库存再扣减为什么会在并发下超卖
  • 用 Lua 把状态检查与库存扣减收进同一原子边界
  • 定义库存不足、活动未开始等可直接快速失败的返回语义

先查再减会留下竞态窗口

如果应用先执行 HGET stock,确认库存大于零后再发送 HINCRBY stock -1,两条命令之间存在网络往返和线程调度窗口。库存只剩 1 时,请求 A、B 可能都先读到 1,于是都认为自己有资格下单。

即使第二步使用原子的 DECR 或 HINCRBY,也只保证“单次减法”原子,并不能把前面的资格判断一起保护起来。应用若已经在两次读取后分别放行,就可能出现库存变成负数或业务侧卖出两份的结果。

先查再减与 Lua 原子扣减时序对比

把判断和扣减放进一个脚本

Redis 执行 Lua 脚本时,会把脚本内的 Redis 命令作为一个不可被其他命令插入的原子操作。下面脚本约定:成功时返回扣减后的剩余库存,-1 表示库存不足,-2 表示活动状态不是 RUNNING,-3 表示购买数量非法。

lua
local qty = tonumber(ARGV[1])
if not qty or qty <= 0 then
  return -3
end

-- 活动未启用时直接失败,不触碰库存。
local status = redis.call('HGET', KEYS[1], 'status')
if status ~= 'RUNNING' then
  return -2
end

-- 库存判断和扣减都留在脚本内,避免客户端往返形成竞态窗口。
local stock = tonumber(redis.call('HGET', KEYS[1], 'stock') or '-1')
if stock < qty then
  return -1
end

local left = redis.call('HINCRBY', KEYS[1], 'stock', -qty)
return left

这是完整的 deduct.lua。生产脚本应保持短小,禁止在脚本里做耗时循环;Lua 在 Redis 主执行线程上运行,脚本过重会直接放大所有请求的延迟。

运行并验证快速失败

先把脚本保存为当前目录下的 deduct.lua,然后执行下面命令。示例把库存设置为 2,连续购买三次,每次购买 1 件。

bash
KEY="flash:{activity:1001}:v:20260912"

redis-cli DEL "$KEY" >/dev/null
redis-cli HSET "$KEY" status RUNNING stock 2 >/dev/null

# 前两次应成功,第三次在 Redis 内直接判定库存不足。
redis-cli --eval deduct.lua "$KEY" , 1
redis-cli --eval deduct.lua "$KEY" , 1
redis-cli --eval deduct.lua "$KEY" , 1
redis-cli --raw HGET "$KEY" stock

预期输出

text
1
0
-1
0

前两次扣减成功,返回扣减后的剩余库存;第三次直接返回 -1,库存仍保持为 0,没有出现负数。应用收到 -1 后应立即返回“库存不足”或“已售罄”,不要再访问数据库确认一次,否则会把已经挡在 Redis 的高并发重新引回热点数据库。

返回码要和业务动作绑定

建议把 Lua 返回值映射成稳定的业务语义:非负数表示成功并携带剩余库存,-1 只表示库存不足,-2 表示活动不可售,-3 表示请求参数错误。这样调用方无需再次查询 Redis 就能决定后续动作。

在 Redis Cluster 中,脚本访问的所有键必须满足集群的 slot 约束。示例只访问 KEYS[1];如果以后把用户限购键也放进同一脚本,应使用相同 hash tag,并把实际访问的键通过 KEYS 显式传入,而不是在脚本里随意拼接跨 slot 键。

当库存耗尽时,最重要的性能语义是在 Redis 内立刻失败。只要调用方不再回源数据库,这个 Lua 原子边界就同时守住了“不超卖”和“售罄后不放大后端压力”两条底线。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Lua 原子校验并扣减库存

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

登录哪都通