EX/PX仅控制TTL,真实锁超时精度受本地时间漂移、网络延迟、主从同步滞后影响;优先用PX而非EX,避免取整误差,禁用客户端时间戳比对,应以Redis为唯一可信时钟源。

Redis SET 命令的 EX/PX 参数不等于实际锁超时精度
很多人以为用 SET key value NX EX 30 就能保证锁最多持锁 30 秒,但这是错觉。Redis 的 EX(秒级)和 PX(毫秒级)只控制 key 的 TTL,而真实超时精度还受三方面干扰:客户端本地时间漂移、网络往返延迟、Redis 主从同步滞后。尤其在跨机房部署或 NTP 同步不稳时,EX 30 可能导致某节点认为锁已过期而另一节点仍视其有效。
- 优先用
PX而非EX:哪怕业务预估是整秒,也写成PX 30000,避免 Redis 内部取整误差 - 不要依赖
redisClient.SetNX(ctx, key, val, 30*time.Second)这类封装——它底层可能仍转为EX;查你所用 redis client 库的源码确认是否透传PX - 若使用
go-redis/redis/v8,直接调Set(ctx, key, val, time.Duration)即可,它会自动选PX(当time.DurationPX,≥1s 则按需)
锁续期(Lease Renewal)必须用 Lua 脚本校验 token + PX
长任务靠单纯设大 TTL 不行,必须续期;但续期操作本身若不原子,就会引入竞态——比如 A 续期前锁被 B 清掉,A 接着又成功续上,结果 B 拿到锁后 A 还在操作。所以续期不是“延长 TTL”,而是“仅当当前 value 等于我的 token 时,才重设 PX”。
- Lua 脚本必须同时做
GET校验和PEXPIRE(不能用EXPIRE),否则在 sub-millisecond 级别下,两次命令间存在窗口期 - 示例脚本:
if redis.call("get", KEYS[1]) == ARGV[1] then return redis.call("pexpire", KEYS[1], ARGV[2]) else return 0 end -
ARGV[2]必须传毫秒值(如30000),而非time.Duration对象——有些 client 库会自动转,有些不会,务必实测输出 Redis 日志确认
context.WithTimeout 不是锁超时的替代品
context.WithTimeout(ctx, 30*time.Second) 控制的是「获取锁这个动作」的等待上限,不是锁本身的持有时间。它解决的是客户端别卡死在 TryLock 上,和锁会不会被 Redis 自动删掉无关。
- 一个常见错误:把锁 TTL 设成 5 秒,却用
context.WithTimeout(..., 30*time.Second)轮询等待——这会导致大量无效请求打到 Redis,且无法防止锁提前释放 - 正确组合是:TTL 设为「业务最大耗时 × 2~3」(单位毫秒),再配独立的续约协程;
context仅用于限制首次获取锁的阻塞时间(如 500ms) - 续约协程自身也要带
context:启动时传入带 deadline 的 context,并在锁释放或业务完成时调cancel(),避免 goroutine 泄漏
时钟漂移会让所有基于时间的判断失效
如果你在代码里写 if time.Now().After(lockExpire) { unlock() },那这套逻辑在任何有 NTP 调整、虚拟机休眠、容器热迁移的环境里都不可靠。物理时钟不可信,必须把时间判断交给 Redis 服务端。
- 所有“锁是否过期”的判断,只能通过 Redis 的
TTL key或PTTL key获取,且结果要结合客户端 token 校验(例如:先PTTL,若返回 -2 表示 key 不存在,-1 表示无过期,>0 才是剩余毫秒数) - 禁止在客户端计算“当前时间 + TTL”去比对锁创建时间戳——那个时间戳本身可能就来自不同步的机器
- 真正可靠的租约机制,是让 Redis 成为唯一可信时钟源:锁的生死、续期、释放,全部由 Redis 端原子指令驱动
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











