架构与系统设计 / 系统课时
设计一人一单抢购资格
设计一人一单抢购资格
秒杀中的“一人一单”不能只靠接口幂等或订单表唯一索引兜底,因为重复请求可能在订单落库前就多次占用库存。本节把用户资格检查、库存扣减和稳定业务键写进同一原子边界,让重复请求在入口处被识别,并为后续异步建单保留可复用的幂等键。
学习目标
- 设计资格检查与库存扣减不可分割的原子流程
- 使用稳定业务键区分首次成功、重复请求和库存不足
- 理解 Redis Cluster 下原子脚本对 Key 分槽的约束
把资格与库存放进同一一致性边界
核心不变量有两个:同一活动、同一商品、同一用户最多获得一次抢购资格;只有首次获得资格的请求才能消耗一次库存。若先扣库存再写资格,进程在两步之间失败会产生“库存少了但用户没有资格”;若先写资格再扣库存,又可能出现“用户占了资格但没有库存”。
因此,资格键与库存键必须由一个原子操作同时判断和修改。Redis 场景通常用 Lua 脚本完成:先检查用户资格键是否存在,再检查库存是否大于零,只有两项都通过时才扣减库存并写入资格键。

资格键不要只写成 user:<ID>,否则不同活动会互相干扰。一个更稳定的业务维度是“活动 + 商品 + 用户”,例如 order:A100:S200:U300。这个值既可以写入资格键,也可以传给后续消息和订单服务作为幂等键。
用 Lua 完成原子资格判定
下面示例假设本地 Redis 已启动。两个 Redis Key 使用相同的哈希标签 {A100:S200},这样在 Redis Cluster 中会落到同一哈希槽,脚本才能同时访问它们。
redis-cli SET 'seckill:{A100:S200}:stock' 5
redis-cli EVAL '
local stock = tonumber(redis.call("GET", KEYS[1]) or "0")
if redis.call("EXISTS", KEYS[2]) == 1 then
return 2
end
if stock <= 0 then
return 0
end
redis.call("DECR", KEYS[1])
redis.call("SET", KEYS[2], ARGV[1], "EX", 600)
return 1
' 2 'seckill:{A100:S200}:stock' 'seckill:{A100:S200}:user:U300' 'order:A100:S200:U300'
redis-cli EVAL '
local stock = tonumber(redis.call("GET", KEYS[1]) or "0")
if redis.call("EXISTS", KEYS[2]) == 1 then
return 2
end
if stock <= 0 then
return 0
end
redis.call("DECR", KEYS[1])
redis.call("SET", KEYS[2], ARGV[1], "EX", 600)
return 1
' 2 'seckill:{A100:S200}:stock' 'seckill:{A100:S200}:user:U300' 'order:A100:S200:U300'
redis-cli GET 'seckill:{A100:S200}:stock'预期输出
OK
1
2
4返回值约定为:1 表示首次抢购成功,2 表示同一用户重复请求,0 表示库存不足。第二次请求没有再次扣库存,因此最终库存仍为 4。
让后续订单幂等承接同一个业务键
抢购资格成功后,通常还会把请求写入消息队列,再由订单服务异步落库。此时不要重新生成一个与入口无关的随机幂等键,而应继续使用 order:A100:S200:U300 这一稳定业务键。即使消息重复投递,订单服务也能用同一键做唯一约束或幂等写入。
资格键的 TTL 也不能随意设得很短。它至少要覆盖“活动有效期 + 消息积压 + 订单创建重试”这段窗口;如果资格键提前过期,而订单还没可靠落库,同一用户可能再次通过入口检查。对要求永久一人一单的业务,还应由订单库的唯一约束做最终事实层防线。
验收这条链路
验证时至少覆盖首次请求、同用户并发重复、库存耗尽和消息重复四种情况。入口层的正确结果不是“每个请求都返回成功”,而是无论同一用户重试多少次,都只消耗一次库存,并始终得到同一个稳定业务键。