Golang AES-128-CBC解密结果前出现乱码，求正确解决方案

问题根源分析 #

解密后开头出现随机无效字符，最常见的原因是初始化向量（IV）不匹配：

• AES-CBC模式加密时，IV必须是随机唯一的，通常会附加在密文开头（或结尾）一起传输。
• 解密时若未使用加密时的同一IV，第一块明文会完全乱码，后续块不受影响，这和你描述的现象完全吻合。
• 其次可能是密文解码错误（比如base64解码处理不当）或密钥长度不符合AES-128要求（必须是16字节）。

正确解决方法 #

1. 严格匹配加密时的IV #

加密标准流程：

• 生成16字节随机IV（AES-128的IV长度等于块大小16字节）
• 用IV+密钥加密明文
• 将IV拼接在密文前（或后），编码后传输

解密对应流程：

• 解码密文（如base64解码）
• 从解码后的字节中分离出前16字节作为IV，剩余部分为真实密文
• 使用该IV+密钥执行解密

2. 统一PKCS7填充处理 #

Go标准库crypto/cipher未内置填充逻辑，加密和解密必须使用完全一致的PKCS7填充/去填充实现。

正确的解密函数示例 #

package main

import (
	"crypto/aes"
	"crypto/cipher"
	"encoding/base64"
	"fmt"
)

// 去除PKCS7填充
func pkcs7Unpad(data []byte) ([]byte, error) {
	if len(data) == 0 {
		return nil, fmt.Errorf("无效的填充数据")
	}
	paddingLen := int(data[len(data)-1])
	if paddingLen > len(data) || paddingLen == 0 {
		return nil, fmt.Errorf("填充长度不合法")
	}
	return data[:len(data)-paddingLen], nil
}

// AES-128-CBC解密函数
func DecryptAES128CBC(encryptedBase64 string, key []byte) ([]byte, error) {
	// 解码base64密文
	encryptedData, err := base64.StdEncoding.DecodeString(encryptedBase64)
	if err != nil {
		return nil, err
	}

	// 分离IV和真实密文（IV占前16字节）
	if len(encryptedData) < aes.BlockSize {
		return nil, fmt.Errorf("密文长度过短")
	}
	iv := encryptedData[:aes.BlockSize]
	ciphertext := encryptedData[aes.BlockSize:]

	// 创建AES块
	block, err := aes.NewCipher(key)
	if err != nil {
		return nil, err
	}

	// 初始化CBC解密器
	mode := cipher.NewCBCDecrypter(block, iv)

	// 执行解密（直接修改ciphertext切片）
	mode.CryptBlocks(ciphertext, ciphertext)

	// 去除PKCS7填充
	plaintext, err := pkcs7Unpad(ciphertext)
	if err != nil {
		return nil, err
	}

	return plaintext, nil
}

解密函数正确性验证要点 #

检查你的函数是否符合以下要求：

• 密钥长度必须为16字节（AES-128硬性要求），如果是字符串密钥，需确保编码后长度为16字节（如UTF-8编码后刚好16位，或通过哈希算法将长字符串转为16字节）。
• IV必须和加密时完全一致，且长度为16字节，禁止硬编码固定IV（会大幅降低安全性）。
• 密文结构处理正确：如果加密时是IV+密文的组合，解密时必须准确分离两者。
• 填充逻辑匹配：加密用PKCS7填充的话，解密必须对应执行去填充操作，不能遗漏或错误处理。

临时截取能凑效的原因 #

你提到的“截取最后一个|之后的内容”能凑效，大概率是因为加密的明文本身包含|分隔符，而IV错误导致的乱码仅出现在第一块，刚好覆盖到最后一个|之前的内容，所以截取后能得到正确的后半部分，但这只是临时 workaround，根本问题还是IV不匹配或密文结构处理错误。

内容的提问来源于stack exchange，提问作者André Bolinhas