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 与数据库之间的异常差异。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现库存预扣

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

登录哪都通