viper.WatchConfig()仅触发回调，不自动重载配置；必须在回调中先调ReadInConfig()刷新缓存，再调Unmarshal()更新结构体，并用atomic.Value原子替换指针，否则viper.Get()和业务变量始终返回旧值。
viper.WatchConfig() 回调里不调 ReadInConfig 就等于没更新
改完 config.yaml，日志打印“配置已更新”，但 viper.GetInt("port") 还是旧值——这是最常见现象。根本原因：viper.WatchConfig() 只注册 fsnotify 监听并触发回调，不读文件、不解析、不刷新内部缓存。必须在回调第一行显式调用 viper.ReadInConfig()，否则 viper.Get() 读的仍是上次加载进内存的老数据。
还要注意：viper.SetConfigType("yaml") 必须在 viper.ReadInConfig() 之前设置，否则类型不匹配会静默失败或 panic；若首次加载用的是 JSON，后续 Watch 时却写 YAML，也会出错。
- 回调开头必须加错误检查：
if err := viper.ReadInConfig(); err != nil { log.Printf("reload failed: %v", err); return } - 紧接着要
viper.Unmarshal(&newCfg)，否则结构体字段仍为零值（viper.Unmarshal()不 diff，只把当前缓存值写入目标指针） - 别依赖
viper.Get("db.host")实时反映变更：它读的是 viper 自己的 map 缓存，而该缓存仅在ReadInConfig()后刷新
并发读配置时直接赋值 cfg = newCfg 是危险操作
多个 goroutine 同时执行 HTTP handler 或定时任务，如果热更新时直接写 cfg.Port = 8080 或 globalCfg = &newCfg，可能读到“半更新”状态：Port 已变，但 cfg.DBURL 还是旧的，尤其当结构体含嵌套 map 或指针字段时，极易 panic。
正确做法是原子切换配置指针。推荐用 sync/atomic.Value：
立即学习“go语言免费学习笔记（深入）”；
- 声明全局变量：
var globalConf atomic.Value - 初始化时存默认配置指针：
globalConf.Store(&defaultCfg) - 热更新成功后：
globalConf.Store(newCfg)（newCfg是新解析的*Config） - 业务代码固定写法：
conf := globalConf.Load().(*Config)，类型断言不能省，且建议判空
容器/K8s 下 viper.WatchConfig() 静默失效的三大原因
现象是“改了文件没反应”，控制台无报错。排查方向很明确：
-
inotify句柄耗尽：Linux 容器默认/proc/sys/fs/inotify/max_user_watches极低（常为 8192），No space left on device并非磁盘满，而是inotify耗尽。Docker 启动必须加--sysctl fs.inotify.max_user_watches=524288 - 监听路径不是文件：
viper.WatchConfig()要求配置是具体文件（如./config.yaml），不是目录；若挂载为 ConfigMap，需确认路径和权限是否可读 - 文件系统不支持 inotify：某些 overlayfs 或 rootless 容器环境可能禁用 inotify，此时应改用轮询 + hash 校验 fallback 方案
配置字段没生效？先检查 struct 字段是否导出
viper.Unmarshal(&cfg) 不会报错，但字段始终为零值，大概率是以下三类问题：
- struct 字段首字母小写（未导出），
viper无法反射赋值 -
yamltag 拼错或大小写不匹配，比如配置里是db_host: 127.0.0.1，但 struct 写成yaml:"dbhost"或yaml:"DB_HOST" - 嵌套结构体字段未导出，或嵌套 map 中的 value 类型未实现
Unmarshaler接口
调试时可用 viper.AllSettings() 打印原始键值对，再与 struct tag 逐项比对；不要用它直接覆盖结构体，容易漏字段。
