Go微服务AES加密必须严格满足四点：密钥32字节（AES-256）、nonce固定12字节、密文结构为nonce+ciphertext+tag、解密必须显式检查err是否为nil；字段级加密优于整文件加密，密钥严禁硬编码或存配置中心，应从KMS/Vault动态获取并内存清零。
Go 环境装好就能跑加密代码，但直接 go run 一把梭容易卡在密钥读取失败、cipher.ErrAuthentication 静默报错、或解密后字段为空——问题不在算法，而在环境初始化和 crypto 使用姿势。
Go SDK 安装后必须验证的三件事
别只信 go version 输出成功就以为万事大吉。实际加解密代码一跑就 panic，往往栽在这三处：
-
GOROOT和PATH必须指向你刚装的 Go 目录，Linux/macOS 用户尤其注意：手动解压后没配PATH，go mod会找不到工具链 -
GO111MODULE=on建议显式开启（加到 shell 配置里），否则crypto/aes等标准库虽能用，但第三方如golang.org/x/crypto/scrypt会因模块模式关闭而无法go get -
go env -w GOPROXY=https://proxy.golang.org,direct必设，国内不配代理时go mod download卡住，看起来像依赖缺失，其实是网络超时
crypto/aes + cipher.NewGCM 的最小可用模板
网上抄的 AES 示例常漏关键检查点，导致解密总返回 nil 而不报错。真正能进生产用的模板必须包含这四步：
- 密钥长度严格为 32 字节（AES-256）：
key, _ := hex.DecodeString(os.Getenv("AES_KEY_HEX"))，别用[]byte("12345678901234567890123456789012")硬编码 - nonce 固定 12 字节：
nonce := make([]byte, 12)，传 16 字节会直接 panic，不是运行时报错 - 加密输出必须是
nonce + ciphertext + authTag拼接，解密端按偏移硬切：nonce := ciphertext[:12]，data := ciphertext[12:]（tag 已含在 data 尾部） - 解密必须检查错误：
plaintext, err := aesgcm.Open(nil, nonce, data, nil)，忽略err == cipher.ErrAuthFailed就等于放弃防篡改
配置文件中只加密敏感字段，别碰整文件
用 viper 或 mapstructure 解析 YAML/JSON 后，只对特定 key 解密，比如 database.password。整文件加密看似省事，实际带来三个硬伤：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- Git diff 失效：每次密码变更，整个配置文件 hash 变，无法看出哪行改了
- 运维工具瘫痪：
helm template、jq '.database.host'会因 base64 或密文格式报错 - 日志泄露风险翻倍：如果某处 log 打印了整个 config map，所有字段（包括明文 host/port）都可能被意外序列化进日志
正确做法是解析后递归遍历 map，匹配预设敏感键名列表（如 []string{"password", "secret_key", "api_token"} ），仅对值调用解密函数。
密钥绝对不能出现在配置中心或 Git 里
把 AES_KEY_HEX 写进 config.yaml 或 .env 文件提交到仓库，等于把保险柜钥匙焊死在门上。真实项目中密钥只应存在两个地方：
- Kubernetes Secret mount 到容器内路径，如
/etc/secrets/aes-key，服务启动时ioutil.ReadFile读取并strings.TrimSpace清空换行符 - HashiCorp Vault 或 AWS KMS，通过 HTTP API 或 IAM role 动态获取，返回后再
hex.DecodeString；注意 Vault token 有效期，别缓存过久
最容易被忽略的是：密钥加载后，建议用 syscall.Mlock 锁住内存页，防止 swap 到磁盘——哪怕只是临时变量，也得 defer bytes.Fill(key, 0) 清零。
