Go语言操作Etcd实现分布式锁实战：语言学习中的一致性保障-Golang-PHP中文网

裸put无法保证互斥性，必须用txn做cas校验；因put不校验key是否已被占用，两客户端可能同时写入成功导致“双锁共存”，正确做法是compare version==0后opput绑定etcd分配的leaseid。

go语言操作etcd实现分布式锁实战：语言学习中的一致性保障

裸调用 Put 拿不到真正可用的分布式锁，必须用 Txn 做 CAS 校验；否则两个客户端可能同时写入成功，锁就形同虚设。

为什么不能直接 `Put` 加锁？

etcd 的 Put 是非原子写入——它不校验目标 key 是否已被占用。两个客户端几乎同时执行 Put，都可能返回 nil 错误，结果就是“双锁共存”，互斥性彻底失效。

常见错误写法：

_, err := client.Put(ctx, "/lock/order", "1", clientv3.WithLease(leaseID))

这行代码只保证写入带租约的值，但完全不管这个 key 是否已被别人抢先占用了。

正确做法是用 Txn 执行原子比较再写入：

Compare 条件必须是 Version("/lock/order") == 0，这是判断 key “从未存在过”最可靠的依据（比先 Get 再判断 IsNotFound 更严谨，后者有竞态窗口）
Then 分支执行 OpPut，且必须传 clientv3.WithLease(leaseID)
Else 分支可返回失败或重试逻辑

`leaseID` 必须由 etcd 分配，不能手拼

租约不是字符串或时间戳，而是 etcd 内部管理的整型 ID。自己构造 leaseID（比如拼接时间戳、随机数）会导致：

无法续期：KeepAlive 只接受真实分配的 ID
无法自动回收：TTL 到期后 key 不会自动删除，锁永久残留
心跳冲突：多个锁实例混用同一个 leaseID，一个释放会连带干掉其他锁

务必通过 client.Grant(ctx, ttl) 获取，例如：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

leaseResp, err := client.Grant(ctx, 10) // 10秒TTL
if err != nil { /* handle */ }
leaseID := leaseResp.ID

TTL 建议设为 10 秒，续租间隔 ≤ 3 秒（即 TTL/3），避免 GC 抖动或网络延迟导致误过期。

解锁必须校验 value，不能无条件 `Delete`

解锁的本质是：“确认这个 key 的 value 确实是我当初设的”。直接 Delete 或在 defer 里无条件删，风险极高：

删错人：A 拿到锁后处理超时，B 已抢到新锁，A 的 Delete 会把 B 的锁干掉
重复删：panic 跳过 defer，恢复后又执行一次 Delete，造成二次误删

正确方式是用 Txn.CompareAndDelete：

txn := client.Txn(ctx).
    If(clientv3.Compare(clientv3.Value("/lock/order"), "==", myValue)).
    Then(clientv3.OpDelete("/lock/order"))
resp, err := txn.Commit()

其中 myValue 必须全局唯一（推荐 uuid.NewString() 或 os.Getpid() + time.Now().UnixNano()），不能用固定字符串如 "1"。