如何在 Go 中实现基于 Redis 状态同步的分布式锁-Golang-PHP中文网

set key value nx ex 是分布式锁起点，因其原子性确保“仅当键不存在时设值+设过期”一步完成，避免拆分操作导致的死锁或误删；值须为唯一uuid，解锁须用lua脚本校验value后删除，保障安全性。

如何在 go 中实现基于 redis 状态同步的分布式锁

为什么 `SET key value NX EX` 是分布式锁的起点

因为 Redis 的原子性命令是唯一能避免竞态的基石。用 SET 同时完成“设置值 + 设置过期 + 仅当不存在时生效”，三者缺一不可。如果拆成 EXISTS + SET + EXPIRE，中间任何一步失败或被中断，都会导致锁残留或误释放。

实际写法必须是：

SET lock:order:123 "8f4a1e7b-2c9d-4a5f-b6e0-3a1d2c9b8e7f" NX EX 30

其中值必须是全局唯一随机字符串（比如 UUID），不能用进程 PID 或时间戳——否则多个客户端可能生成相同值，后续无法安全校验和释放。

值重复会导致误删别人持有的锁，这是最常见也最危险的错误
NX 保证只在 key 不存在时设置，避免覆盖已有锁
EX 30 必须显式指定，不能依赖客户端延时续期——网络抖动时续期可能失败，而无过期时间的锁等于死锁

如何安全释放锁：为什么不能直接 `DEL`

直接 DEL lock:order:123 会删掉别人刚抢到的锁。必须先校验 value 是否匹配，再删除——但 Redis 没有内置的“校验后删”原子命令，所以要用 Lua 脚本。

标准释放脚本长这样：

if redis.call("GET", KEYS[1]) == ARGV[1] then
  return redis.call("DEL", KEYS[1])
else
  return 0
end

这个脚本必须通过 eval 或 evalsha 执行，且传入的 KEYS[1] 和 ARGV[1] 要严格对应锁 key 和你当初设进去的唯一 value。

redis-tools

按类别查找Redis命令、检测服务器连接、监控键数量和内存占用，支持离线速查表。

下载

漏传 ARGV[1] 或拼错变量名，脚本永远返回 0，锁永久残留
用 Go 的 redis.UniversalClient 时，推荐用 script.Load().Run() 方式预加载脚本，避免每次传输 Lua 字符串开销
别试图用 GET + if + DEL 三步模拟——两步之间可能被其他客户端抢占

Go 客户端怎么封装才不容易出错

核心是把“获取锁”和“释放锁”绑定为同一实例生命周期，避免 value 不一致。不要让调用方自己生成 token 或传入 key。

一个最小可行封装示例：

type RedisLock struct {
  client redis.Cmdable
  key    string
  token  string // 初始化时生成，只读
  expire time.Duration
}

func (l *RedisLock) TryLock(ctx context.Context) (bool, error) {
  ok, err := l.client.SetNX(ctx, l.key, l.token, l.expire).Result()
  return ok, err
}

func (l *RedisLock) Unlock(ctx context.Context) error {
  _, err := l.script.Run(ctx, l.client, []string{l.key}, l.token).Result()
  return err
}

关键点：

token 在 NewRedisLock() 里一次性生成并固定，不暴露给外部
TryLock() 返回 bool 而非 error，因为失败是常态，不是异常
没加自动续期（renew）逻辑——除非业务明确需要长任务，否则续期引入更多复杂度（比如 watch dog 线程、心跳竞争），多数场景 30 秒够用，超时就重试更简单