Redis 与缓存 / 系统课时
实现库存预扣
实现库存预扣
本课使用 Redis Lua 原子检查并扣减库存,同时记录订单预扣状态,避免并发超卖、负库存和同一订单重复扣减,并说明超时释放与数据库落单的边界。
学习目标
- 原子完成库存检查与扣减
- 防止同一订单重复预扣
- 实现幂等释放并用数据库保存最终事实
预扣模型
库存键使用 stock:<skuId>,预扣键使用 stock:reservation:<orderId>:<skuId>。脚本先检查订单是否已经预扣,再读取库存并执行扣减,整个过程不能拆成多条客户端命令。

原子预扣脚本
脚本返回两个值:第一个是状态码,第二个是扣减后的可用库存。状态码 1 表示成功,2 表示该订单已预扣,0 表示库存不足,-1 表示库存键不存在,-2 表示参数非法。
lua
local stockKey = KEYS[1]
local reservationKey = KEYS[2]
local quantity = tonumber(ARGV[1])
local reservationTtl = tonumber(ARGV[2])
if not quantity or quantity <= 0 or not reservationTtl or reservationTtl <= 0 then
return {-2, 0}
end
if redis.call("EXISTS", reservationKey) == 1 then
local currentStock = tonumber(redis.call("GET", stockKey) or "-1")
return {2, currentStock}
end
local currentStock = redis.call("GET", stockKey)
if not currentStock then
return {-1, 0}
end
currentStock = tonumber(currentStock)
if currentStock < quantity then
return {0, currentStock}
end
local remaining = redis.call("DECRBY", stockKey, quantity)
redis.call("SET", reservationKey, quantity, "EX", reservationTtl)
return {1, remaining}将脚本保存为 reserve-stock.lua,验证成功、重复请求和库存不足:
bash
STOCK_KEY="stock:sku-1001:demo-$$"
RESERVATION_1="stock:reservation:order-9001:sku-1001:demo-$$"
RESERVATION_2="stock:reservation:order-9002:sku-1001:demo-$$"
redis-cli SET "$STOCK_KEY" 5
redis-cli --eval reserve-stock.lua "$STOCK_KEY" "$RESERVATION_1" , 2 3600
redis-cli --eval reserve-stock.lua "$STOCK_KEY" "$RESERVATION_1" , 2 3600
redis-cli --eval reserve-stock.lua "$STOCK_KEY" "$RESERVATION_2" , 4 3600预期输出:
text
OK
1) (integer) 1
2) (integer) 3
1) (integer) 2
2) (integer) 3
1) (integer) 0
2) (integer) 3幂等释放
订单取消或超时后,应读取预扣数量、归还库存并删除预扣键。下面的 Lua 脚本重复执行时只会归还一次。
lua
local stockKey = KEYS[1]
local reservationKey = KEYS[2]
local quantity = redis.call("GET", reservationKey)
if not quantity then
return 0
end
redis.call("INCRBY", stockKey, tonumber(quantity))
redis.call("DEL", reservationKey)
return tonumber(quantity)将脚本保存为 release-stock.lua,在同一终端验证重复释放:
bash
redis-cli --eval release-stock.lua "$STOCK_KEY" "$RESERVATION_1"
redis-cli --eval release-stock.lua "$STOCK_KEY" "$RESERVATION_1"
redis-cli GET "$STOCK_KEY"预期输出:
text
(integer) 2
(integer) 0
5一致性与超时边界
预扣键的 TTL 只负责清理幂等记录,不会自动把库存加回。键过期后,同一订单还可能再次扣减。生产系统必须在过期前通过可靠延迟消息、定时补偿或持久化预扣记录完成确认或释放,否则将无法知道应归还多少库存。
Redis 适合承担高并发预扣和快速拒绝,数据库仍应保存最终订单、库存变更和审计记录。确认、取消、补偿和消息重试都要使用订单号保证幂等,并通过对账修复 Redis 与数据库之间的异常差异。
按自己的节奏,确认真正理解。