viper.Unmarshal不会自动校验字段合法性，必须手动加验证逻辑：需在解码后立即用validator库校验，如Port int validate:"required,gt=0,lt=65536"，失败则log.Fatal退出；环境变量映射须严格匹配大小写与下划线规则；热更新需在OnConfigChange中重新Unmarshal并校验；敏感字段应通过K8s Secret注入而非.env文件。
viper.Unmarshal 不会自动校验字段合法性，必须手动加验证逻辑——这是配置注入后最常被忽略的一环。
配置结构体绑定后不校验，服务可能带着错误配置启动
Go 微服务里用 viper.Unmarshal 把 YAML/JSON 映射到结构体很常见，但这个过程只做类型转换，不检查值是否合理。比如 Server.Port 被设成 -1 或 65536，Database.URL 是空字符串，viper 照样成功返回，服务照常启动，直到监听失败或数据库连不上才报错。
- 必填字段缺失时，结构体对应字段会是零值（
""、0、nil），不会触发 panic 或 error -
viper.Get和viper.GetString类函数也一样，返回零值不报错 - 建议在
viper.Unmarshal后立刻做字段级校验，而不是等 runtime 出问题 - 可用
github.com/go-playground/validator/v10绑定 struct tag，例如Port int `validate:"required,gt=0,lt=65536"` - 校验失败应直接
log.Fatal或返回 error 并退出，别让带病配置进入运行时
环境变量优先级高，但拼写错误时静默失效
viper.AutomaticEnv() 开启后，环境变量会覆盖配置文件同名 key，但前提是变量名和结构体字段的映射关系完全匹配。Golang 默认把结构体字段转成全大写下划线格式（如 DB_URL 对应 Database.URL），一旦命名不一致，变量就不起作用，且无任何提示。
- 字段
URL string `mapstructure:"url"`→ 环境变量需为DATABASE_URL，不是DB_URL或DATABASEURL - 嵌套结构体如
Redis.Addr，对应环境变量是REDIS_ADDR，不是REDIS_ADDRESS - 用
viper.Debug()可打印当前所有已加载的键值，确认变量是否被识别 - 开发时建议在
LoadConfig结尾加一行log.Printf("config loaded: %+v", cfg)，快速核对关键字段是否被正确覆盖
远程配置中心（etcd/Consul）热更新时结构体字段不自动刷新
用 viper.AddRemoteProvider 接入 etcd 后，调用 viper.WatchRemoteConfig 能监听变更，但 viper.Unmarshal(&cfg) 不会自动重执行——你得自己注册回调，在变更触发时重新解码。
- 常见错误：只调了
viper.WatchRemoteConfig，没在viper.OnConfigChange里重新viper.Unmarshal - 结构体指针
&cfg是固定地址，不重新解码，字段值永远停留在首次加载时的状态 - 注意并发安全：热更新期间可能有 handler 正在读
cfg，建议用sync.RWMutex包一层，或换用原子指针（atomic.Value存 *Config） - 变更回调里应包含校验逻辑，避免非法新值直接替换旧配置
敏感字段不能靠 .env 文件管理，K8s 中必须用 Secret 注入
本地开发用 .env 文件方便，但它的格式限制多（不能有空格、引号、注释），且 Git 容易误提交。更重要的是，Docker/Kubernetes 环境中，.env 文件本身不参与容器构建或调度，硬编码或挂载进去都违反安全规范。
立即学习“go语言免费学习笔记（深入）”；
-
.env文件里的PASSWORD=xxx在 K8s 中应转为Secret对象，再通过envFrom.secretRef注入 - 字段名大小写要严格匹配：K8s Secret 的 key 是
DB_PASSWORD，代码里就要用DB_PASSWORD，不是db_password - 不要在代码里拼接
os.Getenv("DB_USER") + ":" + os.Getenv("DB_PASSWORD")构造 URL——万一密码含特殊字符（如@或/）会导致解析失败 - 建议统一用
viper.GetString("database.url")，让 URL 字符串由运维人员或 CI 流程完整提供
