viper.WatchConfig()仅触发回调不自动重载，必须在OnConfigChange中手动调用ReadInConfig和Unmarshal，否则viper.Get()始终返回旧值；常见错误是只注册监听却未执行重载逻辑，且需注意SetConfigType前置、路径匹配、原子替换及组件主动响应。
viper.WatchConfig() 不会自动重载配置，只发事件；必须在回调里手动调 viper.ReadInConfig() 或 viper.Unmarshal()，否则所有 viper.Get() 都返回旧值。
为什么 viper.WatchConfig() 没反应
常见现象：改了 YAML 文件，日志打印 “配置已更新”，但 viper.GetInt("port") 还是旧值。根本原因不是监听失败，而是你只注册了回调，没真正重载。
-
viper.WatchConfig()本质是启动fsnotify.Watcher，只监听文件系统事件（如 WRITE），不读文件、不解析、不刷新内部缓存 - 必须在
viper.OnConfigChange()回调里显式执行：if err := viper.ReadInConfig(); err != nil { ... } -
viper.SetConfigType("yaml")必须在viper.ReadInConfig()之前调用，否则反序列化静默失败或 panic - 编辑器保存常触发临时文件 rename，仅监听目录可能漏事件；应监听具体文件路径，如
"./config.yaml"
etcd/consul 配置中心怎么热更新
viper.AddRemoteProvider() 是一次性拉取，不支持 watch —— 这是个长期被误用的陷阱。
- 正确做法：用
clientv3.Watch()（etcd）或consulapi.KV.Watch()（consul）监听 key 前缀（如/services/order/config），收到变更后把新字节流喂给viper.ReadConfig(bytes.NewReader(data)) - 避免单 key 监听：consul kv.Get 返回
*api.KVPair，但pair.Value可能为nil，直接json.Unmarshal(pair.Value, &cfg)会 panic - 每次回调必须完整解析整个配置结构（JSON/YAML 字节流），
viper不支持局部 patch 或 merge - 首次加载失败必须
log.Fatal或panic，空配置上线比启动失败更难定位
配置更新后，组件怎么响应
热更新 ≠ 变量变，服务就自动生效。数据库连接池、HTTP 客户端、gRPC 连接这些资源，必须你主动重建或调 API。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
-
sql.DB.SetMaxOpenConns()和SetMaxIdleConns()可运行时调用，直接生效 -
http.Client.Timeout等字段不可变，只能新建*http.Client实例，再用sync/atomic或互斥锁原子替换引用 - 日志级别可热更，但需调
log.SetLevel()（logrus）或cfg.AtomicLevel().SetLevel()（zap） - 路由规则、限流策略不能硬编码在 handler 里，得封装成工厂函数，每次变更重建 handler 实例
结构体字段没生效？先查 tag 和导出性
反序列化失败最常被忽略的点：字段未导出、tag 写错、大小写不匹配。
- 结构体字段必须首字母大写（导出），小写字段即使有
json:"xxx"也不会被mapstructure解析 - 统一用
mapstructure:"xxx"tag（比json更适配 YAML/TOML），并开启下划线转驼峰：viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_")) - YAML 中是
redis_url，结构体字段叫RedisUrl，就必须写mapstructure:"redis_url"，否则字段始终为零值 - 别只打
"reload success"，要log.Printf("config reloaded: %+v", cfg)，确认字段真被赋值
真正的难点不在“怎么读新配置”，而在“什么时候该重载”和“哪些组件要响应”。比如 db.max_open_conns 改了，你得调 db.SetMaxOpenConns()；grpc.keepalive.time 变了，得重建连接。这些逻辑没人替你写，全得在回调里显式处理。
