Redis 与缓存 / 系统课时
实现接口幂等控制
实现接口幂等控制
本课使用唯一请求标识和 Redis 抢占执行权,避免网络重试或重复提交造成重复扣款、重复下单。你将区分处理中与成功状态,并安全地更新首次执行结果。
学习目标
- 设计稳定且有业务含义的幂等键
- 区分首次执行、处理中和已成功状态
- 理解 Redis 拦截与数据库最终约束的职责
幂等状态流程
客户端必须为同一次业务操作复用同一个 requestId,服务端构造 idempotent:<operation>:<requestId>。键不存在时由一个请求进入 PROCESSING;重复请求读取现有状态,不再重复执行业务。

抢占执行权
Lua 在一次原子执行中读取现有状态或写入处理中状态。执行令牌用于证明哪个请求获得了本次执行权。
lua
local key = KEYS[1]
local processingTtl = tonumber(ARGV[1])
local executionToken = ARGV[2]
local value = redis.call("GET", key)
if value then
return value
end
redis.call("SET", key, "PROCESSING:" .. executionToken, "PX", processingTtl)
return "ACQUIRED"成功后不能直接无条件覆盖键,应再次校验执行令牌:
lua
local key = KEYS[1]
local executionToken = ARGV[1]
local resultValue = ARGV[2]
local resultTtl = tonumber(ARGV[3])
if redis.call("GET", key) ~= "PROCESSING:" .. executionToken then
return 0
end
redis.call("SET", key, resultValue, "PX", resultTtl)
return 1分别保存为 idempotent-acquire.lua 和 idempotent-complete.lua,再执行主流程:
bash
KEY="idempotent:payment:req-1001:demo-$$"
redis-cli --eval idempotent-acquire.lua "$KEY" , 30000 exec-a
redis-cli --eval idempotent-acquire.lua "$KEY" , 30000 exec-b
redis-cli --eval idempotent-complete.lua "$KEY" , exec-a SUCCESS:order-9001 86400000
redis-cli GET "$KEY"预期输出:
text
"ACQUIRED"
"PROCESSING:exec-a"
(integer) 1
"SUCCESS:order-9001"只有得到 ACQUIRED 的请求可以执行业务。重复请求看到 PROCESSING 时返回处理中,看到 SUCCESS 时返回首次成功结果。
一致性边界
业务提交前失败,可在校验执行令牌后删除 PROCESSING,允许重试。数据库已经提交但 Redis 更新失败时不能直接清除幂等键,否则下一次请求可能再次执行业务。
关键业务应让数据库唯一索引、订单状态条件更新或幂等记录表成为最终防线。Redis 适合快速拦截重复请求,但无法自动提供 Redis 与数据库之间的跨系统事务。
按自己的节奏,确认真正理解。