aes.newcipher仅处理16字节块,不能直接加密字符串;必须配合cbc/gcm模式、pkcs#7填充、16字节iv/12字节nonce及正确切片操作,否则必panic或乱码。

aes.NewCipher 本身不加密完整数据,只提供底层块加密能力;直接调用它加解密任意字符串必然 panic 或产出乱码。必须组合模式(如 cipher.NewCBCEncrypter 或 cipher.NewGCM)、填充、IV/nonce 管理和字节切片编码,缺一不可。
为什么 aes.NewCipher 加密字符串会 panic?
因为 aes.NewCipher 返回的是一个 cipher.Block,它只处理**恰好 16 字节**的输入:
- 传入 []byte("hello")(5 字节)→ CryptBlocks 调用时 panic:crypto/cipher: input not full block
- 忘记分配 dst 切片或长度不足 → 运行时 panic:invalid memory address or nil pointer dereference
- 用字符串字面量硬编码密钥,比如 []byte("mykey")(5 字节)→ aes.NewCipher 直接 panic:crypto/aes: invalid key size
- 密钥长度必须严格为 16 / 24 / 32 字节:用
len([]byte(key))检查,不是len(key) - 明文必须是 16 字节整数倍:靠
pkcs7Padding补,不能用bytes.Repeat([]byte{0}, n)(zero padding 不可逆) -
dst切片必须预先分配且长度 ≥len(src),否则CryptBlocks写越界
如何安全使用 CBC 模式?
CBC 是兼容性最好的常用模式,但三要素必须齐备:PKCS#7 填充 + 随机 IV + cipher.NewCBCEncrypter 包装。
- IV 必须每次加密随机生成(
rand.Read(iv)),长度固定为aes.BlockSize(16 字节) - IV 不需要保密,但绝不能复用;必须和密文一起传输,常见做法是
append(iv, encrypted) - 填充必须在加密前做,去除必须在解密后立即做;顺序错位会导致末尾 1–16 字节乱码
- 解密时先从密文开头切出 16 字节作 IV,剩余部分传给
NewCBCDecrypter,再调pkcs7Unpad - 别写死 IV(如
make([]byte, 16))或用时间戳——相同明文会产出可预测密文前缀
为什么推荐优先用 GCM 而不是自己拼 CBC+HMAC?
cipher.NewGCM 是 AEAD(认证加密)模式,一步完成加密+完整性校验;而手写 CBC+HMAC 极易出错,且 Go 标准库不提供现成封装。
- GCM 的
nonce通常设 12 字节(Go 默认),不是 16 字节;长度错或重用会导致密钥泄露 -
aead.Seal输出已含 nonce + ciphertext + tag,**不要手动append(nonce, cipher)** —— 这绕过认证逻辑 - 解密时
aead.Open必须传入和加密时**完全一致**的nonce和additionalData(哪怕为空切片) - 失败报
crypto/cipher: message authentication failed,90% 是nonce不匹配或additionalData漏传 - 网络传输建议:单独发 12 字节
nonce,再发Seal返回的密文(不含nonce)
密钥和 IV 从哪来?怎么避免常见编码陷阱?
密钥和 IV 都是二进制数据,不是 UTF-8 字符串;所有字符串到 []byte 的转换都需确认来源和编码。
- 密钥别用
[]byte("pass123"):中间有\x00会被 C 风格截断;含 emoji 或中文时len(key)≠len([]byte(key)) - 推荐派生方式:
sha256.Sum256([]byte(passphrase)).[0:32],比md5更通用 - IV 必须每次加密新生成,用
crypto/rand.Read(不是math/rand) - 密钥来自 base64?用
base64.StdEncoding.DecodeString(keyB64),别直接[]byte(keyB64) - 调试时打印用
fmt.Printf("%x", data)或base64.StdEncoding.EncodeToString(data),避免 UTF-8 解释干扰
实际加解密逻辑里最脆弱的环节不在算法本身,而在密钥长度校验、IV 生成与拼接、填充与去填充的边界判断——这些地方出错不会报明确错误,只会静默产出可解但内容错误的数据。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











