aes-gcm nonce必须为12字节，密文结构为nonce+ciphertext+authtag；rsa加密明文上限约190字节（2048位），长数据需先aes加密再rsa封装密钥；viper不支持点号路径set，需递归修改map；密钥禁止硬编码，须从环境变量或kms获取。
crypto/aes 用 AES-GCM 加密配置字段时 nonce 长度必须是 12 字节
GoLand 里写 Golang 加密逻辑，cipher.NewGCM 要求每次加密用唯一 nonce，且长度固定为 12 字节——不是 16、不是 8，错 1 字节就 panic。很多人抄 CBC 示例改 GCM，把 make([]byte, aes.BlockSize)（即 16）直接套用，结果 aesgcm.Seal() 崩在 runtime。
- 正确做法：
nonce := make([]byte, 12)+rand.Read(nonce)，记得检查 error - 密文存储结构必须是
nonce + ciphertext + authTag，解密时先切出前 12 字节作 nonce，再传给aesgcm.Open() - 别用时间戳或递增计数器生成 nonce：GCM 对重用极度敏感，同一密钥下重复 nonce 可能导致密钥泄露
rsa.EncryptOAEP 报错 crypto/rsa: message too long 是因为明文超长
RSA 不适合加密大块数据，rsa.EncryptOAEP 的输入上限取决于密钥长度和哈希算法。2048 位 RSA 密钥 + SHA256 时，明文最多约 190 字节；3072 位也只到 318 字节左右。你在 GoLand 里传入一个 JSON 字符串或整个配置片段，大概率触发这个错误。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 真实场景中，RSA 只用来加密 AES 密钥（32 字节）或短 token，不是拿来 encryt database.password 字符串本身
- 如果非要加密长文本，先用
crypto/rand生成随机 AES 密钥，AES 加密原文，再用 RSA 加密该 AES 密钥 - 私钥解密后，必须用
rsa.DecryptOAEP配合相同哈希（如sha256.New()）和 label（通常为nil），否则返回空或乱码
viper 读取加密 YAML 后，对 database.password 字段解密要绕过 Set 的嵌套限制
GoLand 调试时常见现象：viper.Load() 成功加载 YAML，但 viper.Set("database.password", decrypted) 不生效——因为 viper.Set 不支持点号路径写入嵌套 map，它只更新顶层 key。
- 正确流程是先
viper.AllSettings()或用mapstructure.Decode(viper.AllSettings(), &cfg)拿到完整 map 结构 - 递归遍历 map，匹配键路径（如
"database.password"），对命中值调用解密函数 - 解密后直接赋值回原 map，不再走 viper.Set；后续所有逻辑都基于该内存结构，不依赖 viper 的运行时 set
- 别在
viper.OnConfigChange回调里做解密：热重载时可能并发读写 map，需加锁或重建结构
密钥硬编码在代码里会导致 GoLand 运行时被扫描出高危漏洞
GoLand 自带的 security inspection 会标记 key := []byte("my-secret-123") 为 “Hard-coded cryptographic key”，这不是警告，是阻断级问题。CI 流水线或审计工具会直接 fail build。
- 生产环境密钥必须来自环境变量（
os.Getenv("APP_ENCRYPTION_KEY")）或 KMS（如 Vault 的kv/v2API） - 若本地开发需模拟，用
.env文件 +godotenv.Load()，但确保 .gitignore 里包含 .env - 从环境变量拿到的字符串需校验长度：AES-256 要 32 字节，
len(keyBytes) != 32就 panic，别默默截断或补零
aesgcm.Open() 返回 cipher.ErrAuthentication，但很多代码只判 err != nil 就 panic，没区分是密钥错、nonce 错还是密文被篡改——这会让故障排查变成猜谜。
