结论:在go项目中用redis实现分布式锁,应采用set key value nx px expire_ms原子命令、lua脚本释放及随机唯一value组合。因setnx+expire非原子操作易致死锁;del直接删键不校验ownership;get+del两步释放存在竞态;value须全局唯一;过期时间建议为业务最长耗时×2且≤30秒;续期需绑定context防泄漏。

直接说结论:在 Go 项目里用 Redis 做分布式锁,SET key value NX PX expire_ms 原子命令 + Lua 脚本释放 + 随机唯一 value 是当前最稳妥、可落地的组合。别用 SetNX 单独配 Expire,也别用 Del 直接删键。
为什么 SetNX + Expire 会死锁
这两步不是原子操作。进程刚执行完 SetNX 成功,还没来得及发 Expire 就 panic 或被 kill,key 就永远卡在 Redis 里——没过期时间,也不会自动清理。
- Redis 2.6.12+ 后必须用一条命令完成三件事:
SET值、NX条件、PX毫秒级过期 - Go 中用
go-redis/v8的SetNX(ctx, key, value, ttl),第三个参数传time.Duration,底层会自动转成PX指令 -
value必须是全局唯一标识,比如uuid.NewString()或fmt.Sprintf("%d-%d", os.Getpid(), time.Now().UnixNano()),不能写死成"1"或"locked" - 过期时间建议设为「业务最长耗时 × 2」,但不超过 30 秒(主从延迟可能导致误释放)
为什么释放锁必须用 Lua 脚本
GET + DEL 是两步,中间可能被其他协程抢先改写 key 的值。你读到的 value 已不是你设的那个,却还是把锁删了——等于帮别人释放了锁。
Go语言(Golang)1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口,版本号 1.26.0,可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 正确做法是用 Lua 脚本让 Redis 在服务端原子执行「比对
value→ 匹配则删」 - 脚本示例:
if redis.call("get", KEYS[1]) == ARGV[1] then return redis.call("del", KEYS[1]) else return 0 end - 调用时传入
[]string{key}和[]interface{}{value},返回0表示未持有锁 - 注意:不要用
EvalSha省略脚本体,首次部署或 Redis 重启后 SHA 可能失效
go-redis/v8 实现锁的几个关键细节
用官方客户端时,很多坑藏在返回值和上下文控制里。
-
SetNX返回bool和error,必须同时判断err == nil且结果为true才算真正拿到锁 - 锁续期(看门狗)要用另一个 Lua 脚本:
if redis.call("get", KEYS[1]) == ARGV[1] then return redis.call("pexpire", KEYS[1], ARGV[2]) else return 0 end - 续期 goroutine 必须用
context.WithCancel控制生命周期,避免任务结束但续期还在跑 - 如果业务耗时不确定,建议用
RefreshLock配合定时器,而不是盲目拉长初始 TTL
真正难的不是写对那几行代码,而是理解「谁在什么时候能删掉这个 key」——所有错误都源于对 ownership 判断的松动。token 不唯一、释放不校验、续期不绑定 context,任一环节出问题,锁就形同虚设。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










