clientv3.Watch收不到变更主因是watch未启动或静默断开且不报错，需显式加WithPrefix监听目录、WithRev对齐revision、WithPrevKV获取旧值，并在循环中检查resp.Err()与channel状态，结合atomic.Value实现配置原子更新。
clientv3.Watch 收不到变更，不是 etcd 有问题，而是你的 watch 没跑起来，或者跑着跑着静默断了——它不会报错，也不会自动重连。
Watch 启动时漏掉 WithPrefix 或 WithRev 就丢变更
etcd 的 watch 默认从调用时刻的 revision 开始监听，之前的所有写入全被跳过。服务刚启动就改配置，但没反应？大概率是这个原因。
- 监听目录必须显式加
clientv3.WithPrefix()，比如client.Watch(ctx, "/config/prod/", clientv3.WithPrefix())；写成client.Watch(ctx, "/config/prod/")只监听单个 key - 想补全历史变更，叠加
clientv3.WithPrevKV()，这样每个PUT事件里能拿到旧值，方便做 diff - 更精确的做法：先
client.Get(ctx, "/", clientv3.WithLastRev())拿到当前 head revision，再用clientv3.WithRev(lastRev + 1)启动 watch，避免漏掉初始化Get和 watch 建立之间的间隙 - 如果只关注固定几个 key（如
/config/log-level、/config/timeout），直接传多个 key 字符串比WithPrefix更省资源
Watch 循环里不检查 resp.Err() 就会 panic
watchChan 是个只读 channel，网络抖动、lease 过期、etcd 升级都会让它关闭。继续 for range 会触发 send on closed channel 或 invalid memory address。
- 每次循环开头必须判断：
if !ok || resp.Err() != nil -
resp.Err()返回context.Canceled或context.DeadlineExceeded→ 主动退出，指数退避后重建 watch - 返回
rpc error: code = Canceled desc = context canceled→ 不是 etcd 故障，是你的 ctx 被 cancel 了，别重试，要检查 ctx 生命周期 - 其他错误（如连接拒绝、超时）建议立即重试，别 sleep 固定秒数；重试前生成新
ctx, cancel := context.WithTimeout(parentCtx, 30*time.Second)
内存配置更新不原子，高并发下必然 data race
直接 config = newConfig 或用 sync.RWMutex 锁整个结构体，在读多写少场景下要么 panic，要么卡住请求。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 声明全局
var config atomic.Value，初始化时config.Store(&defaultConfig) - watch 回调中解析新值后，先校验（
json.Unmarshal成功、关键字段非空），再config.Store(&newConfig) - 业务代码读取：
cfg := config.Load().(*Config)，必须加类型断言和nil判断 - 别用
sync.Map存整块配置结构体——它适合键值动态增删，不是热替换场景 - 若配置含
map或slice字段，确保它们初始化后不再修改；否则得深拷贝或额外同步
Viper 不能直接接 etcd Watch，必须手动桥接
viper.WatchConfig() 只监听本地文件，对 etcd 完全无效。Viper 本身不支持 etcd 的流式变更机制。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法：监听 etcd 事件 → 解析
resp.Events[i].Kv.Value→ 调用viper.ReadConfig(bytes.NewReader(data))注入内存 - 注意：每次注入前清空 viper 的现有配置（
viper.Reset()），否则旧 key 会残留 - 若配置含嵌套结构（如 YAML 中的 map），确保解析后字段能被 viper 正确映射；建议统一用 JSON 格式降低歧义
- 不要在 watch 回调里直接调用
viper.Set()逐字段设——它不触发OnConfigChange，且无法还原嵌套结构
