Viper不支持Consul实时watch，需手动用consul-api长轮询+ReadConfig重载；Consul连接须显式设Address和Token；viper.AddRemoteProvider已废弃；重载前须判空、解码、加锁；监听应使用路径前缀；配置更新后需显式重建依赖对象。
直接上结论：Viper 本身不支持 Consul 的实时 watch，所谓“开箱即用的热更新”是错觉；必须手动用 consul-api 做长轮询 + viper.ReadConfig() 重载，否则配置改了服务根本收不到。
Consul 连接初始化必须显式设 Address 和 Token
很多人卡在“连不上但没报错”，其实是 consul.NewClient() 默认只连 localhost:8500，且 ACL 关闭时也默认无权限读 kv。实际生产环境几乎都启用了 ACL，不传 Token 就会静默失败。
-
Address必须写完整（如"https://consul.example.com:8501"），不能只写域名或 IP -
Token要从 Consul ACL 系统申请专用 token，不能复用 root token（安全策略通常禁止） - 若用 HTTPS，需额外配置
tls.Config，否则 client 初始化就 panic
别用 viper.AddRemoteProvider，它已废弃且不支持 watch
文档里还留着这个 API，但源码中 remote 包自 v1.12 起就不再维护 watch 逻辑，viper.WatchRemoteConfig() 实际只是个空实现。强行调用只会首次拉一次配置，后续变更完全无响应。
- 必须弃用
viper.AddRemoteProvider("consul", ...) - 改用
client.KV().List()或client.KV().Get()配合WaitIndex手动长轮询 - 每次请求要带
WaitTime: 30 * time.Second，否则 Consul 默认 5 分钟超时，连接堆积后触发限流
重载配置前必须做三件事：判空、解码、加锁
Consul 的 kv.Get() 返回 *api.KVPair，但 pair.Value 可能为 nil（key 不存在 / value 为空），直接传给 json.Unmarshal 或 yaml.Unmarshal 会 panic。
立即学习“go语言免费学习笔记（深入）”；
- 先检查：
if pair == nil || pair.Value == nil，否则 panic - 再解码：用
yaml.Unmarshal(pair.Value, &cfg)，不是viper.ReadConfig(bytes.NewReader(pair.Value))—— 后者要求完整结构体，而 Consul kv 是扁平 key，得自己组装 - 重载时加
sync.RWMutex：防止业务 goroutine 正在读viper.GetString("db.timeout")时，另一路 reload 把底层 map 替换掉，导致并发读写 panic
监听路径要用前缀，不要单 key
Consul 的 watch 机制基于 KV 路径前缀，比如你配的是 /services/order/config.yaml，那改 /services/order/log_level 就不会触发回调——因为它是另一个 key。
- 监听路径应设为前缀，如
/services/order/（结尾带斜杠） - 回调里用
client.KV().List("/services/order/")拉全量，再合并成 YAML/JSON 字节流 - 避免监听
/config这种泛路径，容易被其他服务误写入，引发配置污染
最易忽略的一点：viper 不会自动把新值广播给所有已注册的 struct，viper.Unmarshal(&cfg) 只作用于当前调用时刻的快照；如果业务代码里有缓存的 http.Client 或数据库连接池，必须在 reload 回调里显式重建并替换——没人替你做这件事。
