正确做法是只加密敏感字段值（如database.password、api.token），使用AES-GCM（32字节密钥、12字节随机nonce），base64编码后加ENC[AES-GCM]::前缀存入明文配置，解密应在UnmarshalYAML中拦截完成，而非加载后遍历map。
直接加密整个配置文件是错的——它会让 viper、helm template、jq 全部失效，CI/CD 脚本要额外加解密步骤，还容易把密文当明文提交。真正可落地的做法：只加密 database.password、api.token 这类字段值，其余结构保持明文。
用 aes.GCM 加密单个字段值，不是整文件
整文件 AES 加密会让配置失去可读性、不可 diff、不可用 yq 查看，也绕不开字段定位逻辑。字段级加密才是真实项目中唯一可落地的方案。
- 密钥必须为 32 字节（AES-256），不能用
[]byte("xxx")硬编码；推荐用pbkdf2.Key派生，带 ≥100000 轮迭代和随机 salt -
nonce固定 12 字节：nonce := make([]byte, 12)，每次加密都调用rand.Read(nonce)（必须检查 error） - 密文格式为
nonce + ciphertext + auth_tag（tag 固定 16 字节），再经base64.StdEncoding.EncodeToString编码成单行字符串 - 写入 YAML/TOML 时加前缀标识，如：
ENC[AES-GCM]::YmFzZTY0LWVuY29kZWQtc3RyaW5n
在 UnmarshalYAML 中解密，而不是加载后遍历 map
很多人在 viper.AllSettings() 后递归遍历 map[string]interface{} 解密，但这意味着密文字符串已进入内存，且可能被日志、pprof 或 panic 堆栈意外暴露。真正安全的时机是字段赋值前。
- 只有
gopkg.in/yaml.v3的UnmarshalYAML方法能拦截原始字符串，在赋值前解密，避免明文进 struct - 解密前必须校验密钥长度是否为 32，否则
aes.NewCipher直接 panic -
nonce解码后必须检查长度 == 12，否则cipher.NewGCM(block).Open会 panic（不是返回 error） - 别用
strings.SplitN(raw, "|", 2)解析密文 —— 若 base64 含非法字符会 panic；应先value.Decode(&raw)再安全 decode
密钥文件权限与加载路径必须硬性校验
密钥文件路径不能由配置驱动，否则攻击者改 YAML 就能指定任意路径读取；加载后不校验权限，等于白做加密。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 密钥文件路径建议写死在代码里，如
"/etc/myapp/key.aes"，不可动态拼接 - 用
os.Stat检查文件权限：fi.Mode().Perm() & 0777 == 0400（不能只写>= 0400，否则0444也会通过） - 若用环境变量传密钥路径，至少用
os.LookupEnv显式校验存在性，避免空值导致后续 panic - 开发环境可用
make secrets生成本地密钥文件，但严禁提交 Git；生产环境优先走 Vault 或 AWS KMS
解密失败必须显式报错，不能吞掉或默认 fallback
aesgcm.Open 认证失败时返回 cipher.ErrAuthentication 或 cipher.ErrInvalidLength，不是 nil 就代表成功 —— 乱密钥也可能解出字节流，只是内容错乱。
- 若忽略 error 直接使用返回切片，可能拿到部分解密内容、乱码，甚至看似“成功”但实际已被篡改的数据
- 错误信息不能打全：
log.Printf("decrypt failed: %v", err)可能泄露密钥错误还是 nonce 错误，建议统一返回400 Bad Request并记录简略 trace ID - 不要在日志里打印密文长度或前几个字节 ——
log.Printf("pwd len: %d", len(b))可构成侧信道 - 结构体字段必须主动脱敏：
password string是小写字段，但在本包内fmt.Println仍会输出明文，需实现slog.LogValue或fmt.Formatter
最易被忽略的一点：密钥加载后没锁内存页，一旦进程被 swap 到磁盘，密钥就裸奔了；生产环境务必用 syscall.Mlock 锁住密钥所在内存区域。
