Golang中如何编写一个跨多个服务节点协调的分布式锁函数？Redis结合【指南】-Golang-PHP中文网

直接用SET key value NX PX不足以实现安全分布式锁，因其无法保证锁的原子释放，客户端崩溃可能导致锁永久滞留或多个客户端误判过期而“双持有”。

golang中如何编写一个跨多个服务节点协调的分布式锁函数？redis结合【指南】

为什么直接用 `SET key value NX PX` 不足以实现安全的分布式锁

因为网络分区或节点崩溃时，单次 SET 命令无法保证锁的原子释放；客户端崩溃后锁可能永远不释放，或者多个客户端误判锁已过期而同时续期，导致“双持有”。Redis 官方推荐的 Redlock 算法在多数真实部署中反而增加复杂度且未显著提升安全性，实际项目更倾向使用成熟封装——比如 redis/go-redis 的 Lock 方法，或自己基于 Lua 脚本实现带校验的解锁逻辑。

用 `go-redis` 实现可重入、带自动续期的分布式锁

核心是避免手写 Lua 脚本出错，优先复用库的 redis.NewLock（v9+），它默认使用 SET key value NX PX + 随机 UUID 作为 token，并通过后台 goroutine 自动续期（Extend）。

初始化锁时必须设置 Expiration（如 10 * time.Second），不能依赖 TTL 推断
加锁失败返回 redis.ErrNil，不是 nil 错误，要显式判断：if errors.Is(err, redis.ErrNil)
解锁必须用同一个 client 实例调用 Unlock，不能换连接或新实例——否则 Lua 脚本里比对的 token 不匹配
若业务耗时不确定，启用自动续期：WithAutoRelease(5 * time.Second)，表示锁剩余时间少于 5 秒时触发续期

示例片段：

l := redis.NewLock(rdb, "order:123", &redis.LockOptions{
    Expiration: 10 * time.Second,
    AutoRelease: 5 * time.Second,
})
err := l.Lock(context.TODO())
if err != nil {
    // 处理加锁失败
}
defer l.Unlock(context.TODO()) // 必须 defer，且不能忽略 err