chacha20poly1305.new panic: non-nil key是因为该函数仅接受严格32字节的已派生密钥，不接受原始密码字符串或空/长度错误的字节切片；必须用scrypt.key等kdf派生或rand.read生成合规密钥。
chacha20poly1305.New 为什么 panic: non-nil key？
因为 chacha20poly1305.New 不接受原始密码字符串，只接受已派生的、长度严格为 chacha20poly1305.KeySize（即 32 字节）的密钥切片。传 []byte("pass123") 或空切片 []byte{} 都会触发 panic。
微服务中常见错误是直接把配置里的 password 字符串转成 []byte 就往里塞——这根本不是密钥，只是口令（password），必须先派生。
- 安全做法：用
scrypt.Key派生，参数推荐N=1，输出长度设为 32 - 更简单做法：启动时生成一次随机密钥，存入内存或 secrets manager，后续复用 ——
key := make([]byte, chacha20poly1305.KeySize)+rand.Read(key) - 千万别用
sha256.Sum256([]byte("pass")).[:]——哈希不是密钥派生函数，抗暴力破解能力极弱
nonce 怎么生成才不翻车？
ChaCha20-Poly1305 要求 nonce 长度必须是 chacha20poly1305.NonceSize（12 字节），且**绝对不可重用**。微服务高并发下，用计数器或时间戳极易冲突，一错全崩——密钥流复用等于明文裸奔。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 每次加密前调用
rand.Read(nonce)生成全新 12 字节随机值 - 把 nonce 明文拼在密文前面：
ciphertext = append(nonce[:], ciphertext...) - 解密时先切出前 12 字节作为 nonce，剩余部分才是密文
- 别用
time.Now().UnixNano()当 nonce——多 goroutine 同一纳秒就撞车；也别全局复用一个nonce变量
要不要传 AAD？微服务里哪些字段该放进去？
AAD（Additional Authenticated Data）不加密但参与认证，是防篡改的关键防线。微服务中若忽略它，攻击者可能替换密文却无法被检测。
- 必须传 AAD 的场景：
userID、requestID、tenantID、endpoint—— 这些标识决定了密文归属，换地方解就该失败 - 典型错误：传
[]byte{}，这和传nil完全不同 —— 前者是“长度为 0 的有效 AAD”，后者才是“无 AAD” - HTTP 中间件加密响应体时，把
Status和Content-Type放 AAD，防止篡改响应语义 - 数据库字段加密时，把表名+主键 ID 拼成 AAD，避免密文被错插入其他行
解密失败只报 cipher.ErrAuthentication，怎么快速定位问题？
这是设计使然：不暴露是密钥错、nonce 错还是 AAD 错，防止侧信道攻击。但在微服务排障时，你得靠结构化检查绕过这个黑盒。
- 先验证密文长度：必须 ≥
chacha20poly1305.NonceSize + 16（16 是 Poly1305 认证标签长度），少于这个直接截断 - 确认 nonce 长度是 12 字节，不是 16 或 24 ——
XChaCha20才用 24，普通chacha20poly1305用 12 - 检查 AAD 是否 nil：加密传了
nil，解密就不能传[]byte{}；反之亦然 - 微服务日志里建议打 hash(key) 和 hex(nonce)，方便比对加解密两端是否完全一致（注意别打明文 key）
真正麻烦的不是代码写几行，而是密钥生命周期管理、nonce 生成逻辑与服务部署模型的耦合——比如无状态 Pod 重启后若依赖本地计数器，必然出事。随机 nonce + 外部密钥管理，才是微服务里能长期跑稳的组合。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
