Iris 框架本身不提供分布式锁抽象,但可用 go-redis/v9 在 handler 中手动实现;关键要避免 SETNX+EXPIRE 非原子性及误删他人锁,应使用 Set 的原子 NX+EX 参数加锁,并用 Lua 脚本校验 value 后删除。

直接说结论:Iris 框架本身不提供分布式锁抽象,但你可以用 redis-go(如 github.com/go-redis/redis/v9)在 handler 中手动实现安全的加锁逻辑;关键不是“怎么集成”,而是“怎么避免 SETNX + EXPIRE 非原子性”和“怎么防止误删别人锁”这两个坑。
为什么不能只用 SETNX + EXPIRE
这是新手最常写的写法:
client.SetNX(ctx, "lock:order:123", "my-client-id", 10*time.Second) client.Expire(ctx, "lock:order:123", 10*time.Second)
问题在于这两步不是原子操作。如果 SetNX 成功但 Expire 因网络抖动失败,锁就永远不超时——死锁。Redis 6.2+ 虽支持 SET key value PX 10000 NX 一条命令搞定,但 Go 客户端默认不封装成原子调用,得自己拼命令或用 Eval。
推荐用 SET 命令的原子参数(v9 客户端)
Go-redis/v9 的 Set 方法原生支持 NX 和过期时间,这才是安全起点:
-
client.Set(ctx, "lock:order:123", clientID, 10*time.Second).Val()返回true表示加锁成功 -
clientID必须是唯一值(建议用uuid.NewString()),后续释放锁时用来校验所有权 - 不要用固定字符串如
"1"或"true"作 value,否则无法做「谁加的锁谁删」校验 - 超时时间要结合业务最大执行时间设(比如下单接口通常 ≤3s,设 5–10s 更稳妥)
释放锁必须用 Lua 脚本校验再删
单纯 DEL lock:xxx 是危险的——A 加的锁,B 在 A 还没执行完时就删了,导致并发破坏。正确做法是 Lua 脚本一次性判断 + 删除:
const unlockScript = `
if redis.call("GET", KEYS[1]) == ARGV[1] then
return redis.call("DEL", KEYS[1])
else
return 0
end
`
result := client.Eval(ctx, unlockScript, []string{"lock:order:123"}, clientID).Val()
注意:clientID 必须和加锁时完全一致;result 是 int64,等于 1 才算释放成功。
Iris handler 中的实际结构建议
别把锁逻辑塞进业务代码里,抽成可复用的 middleware 或 helper:
- 加锁失败时,返回
iris.StatusTooManyRequests或自定义错误码(如423 Locked),而不是阻塞重试 - 用
ctx.WithTimeout控制整个加锁等待时间(比如最多等 200ms),避免请求堆积 - 锁 key 命名要有业务上下文,比如
lock:pay:order_id:789,避免不同资源共用一个 key 空间 - 务必 defer 解锁,但要在 handler return 前显式调用,别依赖
defer在 panic 时兜底——panic 后可能来不及执行
真正容易被忽略的点是:锁的粒度和业务生命周期是否对齐。比如一个支付回调接口,加锁 key 如果只按 order_id,但实际要更新用户余额、订单状态、库存三张表,就得确认这三者是否真的需要强一致性串行——有时最终一致性 + 补偿更合适,硬上分布式锁反而拖垮吞吐。


















