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 与数据库之间的跨系统事务。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现接口幂等控制

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

登录哪都通