Redis 与缓存 / 技术文章

Redis 分布式锁为什么不能只写 SETNX

这篇文章面向已经知道 Redis 可以做分布式锁、但实现还停留在 SETNX 的后端开发者。你会理解 SETNX 为什么只能保证“谁先抢到 Key”,却不能完整保证锁的生命周期和归属,并掌握原子过期、唯一 token、安全解锁与续期的基本实现边界。

SETNX 只解决了“谁先拿到锁”

SETNX 的作用很简单:只有 Key 不存在时才写入成功。

bash
redis-cli SETNX lock:order:<ID> <TOKEN>

预期输出:

text
(integer) 1

返回 1 表示当前调用成功创建了锁 Key;如果其他实例已经创建,则返回 0。

这确实能解决最基础的互斥竞争,但它只回答了一个问题:谁先把锁 Key 写进去。

真正可用的分布式锁,还必须回答:

  • 持锁进程崩溃后,锁怎么自动释放
  • 锁过期以后,旧持有者还能不能误删新锁
  • 业务执行太久时,锁是否需要续期
  • 解锁动作如何保证“检查归属”和“删除”原子执行
  • 网络超时后,客户端怎么判断自己到底有没有拿到锁

因此,只写 SETNX 远远不够。

SETNX 与完整 Redis 分布式锁流程对比

最大的问题是 SETNX 成功后进程可能直接崩溃

最经典的错误实现是:

text
SETNX lock:key token
EXPIRE lock:key 30

片段示例:这里用于说明两个独立命令之间的故障窗口。

如果 SETNX 成功后,应用还没来得及执行 EXPIRE 就崩溃,那么这个锁 Key 将没有过期时间。

后续所有实例都会认为锁一直被占用,最终形成永久死锁。

这也是为什么“先 SETNX,再 EXPIRE”不安全。正确方案必须让“只有不存在时写入”和“同时设置过期时间”在一个 Redis 命令里原子完成。

正确加锁应该直接使用 SET NX PX

Redis 的 SET 命令已经能够同时表达“仅当不存在时写入”和“设置 TTL”:

bash
redis-cli SET lock:order:<ID> <TOKEN> NX PX 30000

预期输出:

text
OK

如果锁已存在,则不会返回 OK。

这里的含义是:

  • NX:锁不存在时才创建
  • <TOKEN>:当前持有者的唯一标识
  • PX 30000:锁在 30 秒后自动过期

这样即使应用在加锁后立即崩溃,Redis 也会在 TTL 到期后自动释放锁,不会永久占用。

为什么锁 Value 不能随便写一个 1

很多简单实现会把锁写成:

text
lock:order:123 = 1

这会失去一个关键能力:判断“当前锁到底属于谁”。

假设 Service A 获取锁,执行时间超过 TTL,锁自动过期;随后 Service B 获取了同名锁。如果 Service A 恢复后直接执行 DEL,就会把 Service B 的锁删掉。

所以锁 Value 应该是每次获取时都不同的唯一 token,例如 UUID 或其他足够唯一的随机值。

真正的解锁条件应该是:

只有 Redis 中保存的 token 仍然等于自己的 token,当前实例才有资格删除这个锁。

解锁必须把判断和删除做成原子操作

错误方式是先 GET,确认 token,再单独执行 DEL。

因为在这两个命令之间,锁可能刚好过期并被其他实例重新获取。

正确方式通常是通过 Lua,把“读取 token”和“删除”放到 Redis 服务端一次执行:

bash
redis-cli EVAL "if redis.call('GET', KEYS[1]) == ARGV[1] then return redis.call('DEL', KEYS[1]) else return 0 end" 1 lock:order:<ID> <TOKEN>

预期输出:

text
(integer) 1

返回 1 表示成功删除自己持有的锁;返回 0 表示锁已经不存在,或锁已经不属于当前调用者。

TTL 也不是设上就结束了

即使使用 SET ... NX PX,锁 TTL 仍然需要和业务执行时间匹配。

TTL 太短,业务还没执行完锁就过期,其他实例会提前进入临界区;TTL 太长,持锁实例宕机后恢复时间又会变慢。

如果临界区执行时间稳定,可以直接设置一个带安全余量的 TTL。

如果执行时间不可预测,可以考虑 watchdog 自动续期。续期时同样必须先确认 token 仍然属于当前持有者,不能无条件延长某个同名 Key。

否则锁已经被别人重新拿到,旧实例仍可能错误地给新持有者续期。

SETNX 还解决不了超时和不确定结果

分布式系统里还有一个常见问题:客户端发出了加锁请求,但网络在响应返回前超时。

此时客户端并不知道 Redis 到底有没有成功写入锁。

可能出现两种情况:

  • Redis 实际没有执行成功
  • Redis 已经执行成功,只是响应没回来

这也是为什么真实工程里不能只看一条 SETNX 命令,还要考虑客户端超时、重试和异常恢复策略。

如果客户端在结果不确定时盲目重试,可能制造新的锁竞争;如果直接认为失败,又可能留下一个自己实际已经持有的锁。

因此高质量实现通常直接使用成熟客户端库,例如 Redisson,而不是每个业务团队自己拼命令和异常路径。

什么时候自己实现,什么时候用成熟组件

如果只是学习原理,手写 SET NX PX + token + Lua 解锁 很有价值。

但生产系统还会遇到:

  • 自动续期
  • 可重入
  • 公平锁
  • 超时等待
  • 网络异常恢复
  • 客户端连接中断
  • 监控和诊断

这些细节很容易被遗漏。

因此工程实践中更推荐使用成熟实现,再理解它底层为什么这么做,而不是把 SETNX 包一层方法就当成“分布式锁组件”。

一把可靠的 Redis 锁至少要满足这些条件

可以用下面这份检查项判断实现是否完整:

  • 加锁和设置 TTL 必须原子
  • 每次持锁都有唯一 token
  • 锁必须有过期时间
  • 解锁前必须校验 token
  • 校验和删除必须原子
  • 续期只能由当前持有者完成
  • 需要考虑客户端超时和网络不确定性
  • 高正确性场景仍要结合幂等、数据库约束或 fencing token

最终可以记住一句话:SETNX 只负责“抢到锁”,真正的分布式锁还必须负责“锁会过期、锁有主人、只能主人释放、超时后还能恢复”。 只写一个 SETNX,离生产可用还差完整的一整套锁生命周期设计。

目录与阅读设置

记录一个想法

Redis 分布式锁为什么不能只写 SETNX

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

登录哪都通