敏感配置必须手动AES-GCM解密：Gin不处理加解密，需在viper加载后递归遍历内存结构，按预设路径匹配ENC[AES-GCM]::前缀字段，用正确密钥/nonce解密并原位赋值，失败时仅返回泛化错误且不记录细节。
敏感配置参数不能靠 Gin 自己加密读取——viper.ReadInConfig 或 gin.BasicAuth 都不碰加解密逻辑，所有字段级 AES-GCM 加解密必须手动写、手动触发。
为什么不能在 gin.BasicAuth 里直接加密密码
gin.BasicAuth 只做凭据校验，它拿到的是明文密码字符串（来自 Authorization 头 Base64 解码后），不会也不该去解密配置里的密文。如果你把 "admin": "ENC[AES-GCM]::YmFzZTY0..." 直接塞进 gin.Accounts，运行时会 panic 或静默失败，因为 gin.Accounts 是 map[string]string，不是解密器。
- Basic Auth 的密码必须是运行时可比对的明文（或 constant-time 哈希值），不是密文
- 配置文件中存的密文，得在 Gin 启动前就完成解密，并注入到内存结构里
- 硬编码或从环境变量直读密码，会导致
/proc/[pid]/environ泄露，ps aux可见
怎么让 viper 加载后解密 database.password 这类字段
核心动作是：先让 viper.ReadInConfig 正常加载 YAML/TOML/JSON，再递归遍历内存中的 map[string]interface{}，对匹配键路径的字符串值调用 aesgcm.Open 解密。
- 用
viper.AllSettings()获取顶层 map，别依赖viper.GetString("database.password")—— 它返回空或默认值，因为此时还是密文字符串 - 预设敏感路径列表，如
[]string{"database.password", "redis.auth", "api.token"}，用点号分隔模拟嵌套路径 - 解密前检查字段值是否含
ENC[AES-GCM]::前缀，避免误解普通字符串 - 解密成功后，必须手动赋值回原 map 结构：比如
dbMap := cfg["database"].(map[string]interface{}); dbMap["password"] = decrypted - 别用
viper.Set("database.password", ...)—— 它不支持嵌套路径写入，会静默失败
解密失败时千万别返回详细错误
aesgcm.Open 失败只返回 cipher.ErrAuthentication 或 cipher.ErrInvalidLength，但业务层不能把这类错误透出给用户或打到日志里。否则攻击者可通过响应时间或错误类型反推密钥是否正确、nonce 是否合法。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 统一返回
http.StatusBadRequest，且响应体为空或泛化提示（如"invalid configuration"） - 日志里也别记
err.Error()，最多记一行"failed to decrypt sensitive config field: database.password" - 解密函数返回
decrypted []byte, err error，必须显式判err != nil，不能只看返回切片长度 - 解密后立即用
bytes.Equal(decrypted, []byte(""))校验非空？不行——这引入时序差异；应统一走空值校验逻辑，和解密错误分离
密钥和 nonce 怎么生成才不踩坑
AES-GCM 对密钥和 nonce 的规格极其严格，错一个字节或复用一次 nonce，整个加密就失效。
- 密钥必须是 32 字节（AES-256），不能用
[]byte("my-key")—— 长度不对会 panic：crypto/aes: invalid key size - 生产环境建议从环境变量读原始字符串，再用
pbkdf2.Key派生（salt 随机、轮数 ≥100000），本地开发可用sha256.Sum256(keyStr).[:32] - nonce 必须每次加密都新生成，固定 12 字节：
nonce := make([]byte, 12); rand.Read(nonce)，绝不能用时间戳或计数器 - 密文存储格式是
nonce + ciphertext + authTag（共 12+N+16 字节），base64 编码后加前缀写入 YAML，解密时先 base64 解码，再拆前 12 字节作 nonce - 密钥严禁硬编码、严禁进 Git、严禁写进 Dockerfile ENV —— 最小权限原则：K8s Secret 挂载文件（权限 0440），Go 用
os.ReadFile读，读完立刻runtime.GC()提示清理（虽不保证，但有信号）
真正麻烦的不是写那几行 aesgcm.Open，而是密钥生命周期管理、解密时机控制、错误掩盖粒度——这些地方一松懈，加密就退化成心理安慰。
