直接加密整个配置文件是错的——它会让viper、jq、helm template全部失效；正确做法是仅加密database.password等敏感字段值，使用aes-gcm（32字节密钥、12字节随机nonce），base64编码后加enc[aes-gcm]::前缀存入明文配置，加载后通过viper.allsettings()递归解密并手动覆写map。
直接加密整个配置文件是错的——它会让 viper、jq、helm template 全部失效，CI/CD 脚本要额外加解密步骤，还容易把密文当明文提交。真正可落地的做法：只加密字段值，比如 database.password 或 api.token，其余结构保持明文。
为什么不能用 base64 或 md5 替代 AES-GCM
base64 是编码不是加密，base64.StdEncoding.EncodeToString([]byte("mypassword")) 输出可逆，日志一打、内存一 dump 就裸奔；md5 和 sha256 是单向摘要，根本无法还原，不满足“存进去、取出来用”的基本需求。只有 aes.GCM 同时提供机密性 + 完整性校验，且 Go 标准库原生支持、已通过 FIPS 验证。
如何用 aes.GCM 加密单个敏感字段值
字段级加密才是真实项目中唯一可落地的方案。密钥不能硬编码，nonce 必须每次随机生成且绝不复用：
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 密钥长度必须为 32 字节（AES-256），推荐用
sha256.Sum256([]byte(os.Getenv("CONFIG_KEY"))).Sum(nil)[:32]派生，避免[]byte("xxx")导致 panic:crypto/aes: invalid key size - nonce 固定 12 字节：
nonce := make([]byte, 12)，调用rand.Read(nonce[:])填充（必须检查 error） - 加密输出为
nonce + ciphertext + auth_tag，再经base64.StdEncoding.EncodeToString编码成单行字符串，写入 YAML/TOML 对应字段，如：ENC[AES-GCM]::YmFzZTY0LWVuY29kZWQtc3RyaW5n - 不要在
viper.ReadInConfig()过程中 hook 文件读取器——这会绕过字段定位逻辑；应在加载完成后调用viper.AllSettings()获取顶层map[string]interface{}，再递归匹配敏感键路径（如["database.password", "redis.auth"]）
解密失败时为什么不能忽略 error
aesgcm.Open 认证失败不会 panic，而是返回 cipher.ErrAuthentication 或 cipher.ErrInvalidLength。若忽略 error 直接使用返回切片，可能拿到乱码、部分解密内容，甚至看似“成功”但实际已被篡改的数据——比报错更危险。
- 必须显式判断
if err != nil，且不要在日志中打印完整 error（可能泄露密钥错误等侧信道信息） - 解密成功后覆写内存中的值；如需更高安全等级，应在业务逻辑使用后立即调用
bytes.Fill清空明文切片 -
viper.Set("database.password", decrypted)不生效——它不支持嵌套路径写入，得先viper.Get("database")取出 map 再手动赋值 - 密钥从环境变量读取时，若未做
strings.TrimSpace或含不可见字符（如换行），会导致cipher.ErrAuthentication且无提示
最容易被忽略的不是算法本身，而是工程衔接点：密钥派生时没校验长度、nonce 复用、解密后明文滞留内存、日志打印了密文长度或部分字节——这些都可能构成侧信道。真正的安全不在“能加密”，而在“解密后不留痕、密钥不落地、字段不越界”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
