必须分开设计租约生命周期与watch语义，否则漏事件或留幽灵实例；clientv3.new须显式设dialtimeout和keepalive参数，注册必绑lease并主动续租，watch须withprefix+withprevkv+兜底get，配置更新需异步消费、加锁保护。
直接说结论：用 clientv3 实现服务发现和配置中心，必须分开设计租约生命周期与 watch 语义，否则不是漏事件就是留幽灵实例。
clientv3.New 配置不设 DialTimeout 就会卡死
etcd 地址写错、DNS 不通、集群全挂时，clientv3.New 默认会阻塞数分钟——不是报错，是彻底卡住，导致服务起不来。
- 必须显式设置
DialTimeout: 3 * time.Second - 加
AutoSyncInterval: 30 * time.Second，应对 etcd 成员动态扩缩容 - 设
DialKeepAliveTime和DialKeepAliveTimeout，防中间设备（如 NAT、防火墙）静默断连
服务注册必须绑定 lease 并主动 keepalive
只调 Put 不带 WithLease，等于把服务地址永久写死。进程崩溃后 key 永不删除，下游持续连接失败。
- 先调
client.Grant(ctx, 15)获取LeaseID（TTL 建议 10–30 秒） - 再用
client.Put(ctx, key, value, clientv3.WithLease(leaseID))写入，key 格式建议统一为/services/{name}/{addr} - 另起 goroutine 调
client.KeepAlive(ctx, leaseID)，并持续读取返回的<clientv3.keepaliveresponse></clientv3.keepaliveresponse>channel；channel 关闭即 lease 过期，应立即退出或重试 - 进程退出前务必调
client.Revoke(ctx, leaseID)，避免残留
Watch 服务列表必须 WithPrefix + WithPrevKV + 兜底 Get
只监听前缀但没设 WithPrevKV，删库事件拿不到旧值，无法区分“主动下线”和“租约过期”；不处理 CompactRevision 断连重连后会丢事件。
- 启动 watch 前，先
client.Get(ctx, prefix, clientv3.WithPrefix())拉一次全量，避免首次事件缺失 - watch 时传
clientv3.WithPrefix()和clientv3.WithPrevKV() - 遍历
WatchResponse.Events时，检查ev.Type是clientv3.EventTypePut还是clientv3.EventTypeDelete；对 Delete，用ev.PrevKv判断是否原值存在，从而区分下线类型 - watch channel 关闭后，不能直接重连，要基于上一次
WatchResponse.Header.Revision重试，并在 revision 被 compact 时 fallback 到全量Get
配置热更新不能只靠 Watch 回调改 map
Watch 回调里直接更新全局变量或结构体字段，容易引发并发读写 panic，且无法保证更新顺序与原子性。
- 用
sync.RWMutex包裹配置读写，写操作锁Lock()，读操作锁RLock() - Watch 回调中只做最小动作：解析新值 → 推入本地
chan string→ 异步 goroutine 持续消费并更新内部map[string]string - 避免在回调里做 HTTP 请求、DB 查询等耗时操作；否则会堵住整个 watch 流，导致后续事件堆积甚至断连
最易被忽略的是：watch 不是“事件队列”，而是“流式快照+增量通知”。revision 跳变、compact、网络抖动都会让事件流不连续，纯依赖事件不做兜底，线上就掉实例。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
