C#中使用AES/CBC/Pkcs7算法解密时遇「输入数据不是完整块」错误

错误核心原因 #

出现该错误的本质是解密的密文长度不符合AES块大小要求（必须是16字节的整数倍），或是密钥、IV与加密方不匹配导致块处理失败。常见触发场景：

• 密钥长度不符合AES规范（仅支持16/24/32字节，对应128/192/256位）
• 加密和解密使用的IV不一致（CBC模式下IV必须完全匹配）
• Base64解码后的密文被截断、篡改，长度不是16的整数倍
• 填充模式与加密方不匹配（即便你用了Pkcs7，也要确认加密方同用该填充）

具体修复方案 #

1. 校验并修正密钥长度 #

AES密钥必须是16、24或32字节。不要直接用Encoding.UTF8.GetBytes(symkey)生成密钥，因为字符串的UTF8长度大概率不符合要求：

• 如果symkey是用户密码，用密钥派生函数生成合规密钥：

  // 示例：基于密码生成128位AES密钥
  using (var deriveBytes = new Rfc2898DeriveBytes(symkey, new byte[16], 10000))
  {
      byte[] key = deriveBytes.GetBytes(16);
  }
  

• 如果symkey是预共享密钥字符串，确保它的UTF8编码后长度是16/24/32字节，否则调整密钥内容。

2. 修正IV的使用逻辑 #

CBC模式下IV不能固定为全0数组，必须和加密方使用的IV完全一致。通常IV会附在密文头部（前16字节），需从密文中提取：

byte[] cipherBytes = Convert.FromBase64String(cipherText);
// 提取前16字节作为IV
byte[] iv = cipherBytes.Take(16).ToArray();
// 剩余部分为实际加密数据
byte[] actualCipher = cipherBytes.Skip(16).ToArray();
// 使用提取的IV调用解密方法
return DecryptStringFromBytes_Aes(actualCipher, validKey, iv);

3. 提前校验密文长度 #

解密前先检查Base64解码后的密文长度是否为16的整数倍，避免触发异常：

public static string Decryptss(string cipherText, string symkey)
{
    try
    {
        byte[] cipherBytes = Convert.FromBase64String(cipherText);
        // 密文长度不符合AES块要求，直接返回原文本
        if (cipherBytes.Length % 16 != 0)
        {
            return cipherText;
        }
        // 替换为你的合规密钥、IV获取逻辑
        byte[] key = GetValidAesKey(symkey);
        byte[] iv = GetMatchingIv(cipherBytes);
        return DecryptStringFromBytes_Aes(cipherBytes, key, iv);
    }
    catch (CryptographicException)
    {
        return cipherText;
    }
    catch (FormatException)
    {
        return cipherText;
    }
}

4. 优化解密方法的流处理逻辑 #

原代码用StreamReader.ReadToEnd()可能无法正确处理CryptoStream的结束逻辑，改用CopyTo读取解密字节更可靠：

public static string DecryptStringFromBytes_Aes(byte[] cipherText, byte[] Key, byte[] IV)
{
    if (cipherText == null || cipherText.Length == 0)
        throw new ArgumentNullException(nameof(cipherText));
    if (Key == null || Key.Length == 0)
        throw new ArgumentNullException(nameof(Key));
    if (IV == null || IV.Length == 0)
        throw new ArgumentNullException(nameof(IV));

    using (Aes aesAlg = Aes.Create())
    {
        aesAlg.Key = Key;
        aesAlg.IV = IV;
        aesAlg.Mode = CipherMode.CBC;
        aesAlg.Padding = PaddingMode.PKCS7; // 显式指定填充模式，避免依赖默认值

        ICryptoTransform decryptor = aesAlg.CreateDecryptor(aesAlg.Key, aesAlg.IV);

        using (MemoryStream msDecrypt = new MemoryStream(cipherText))
        using (CryptoStream csDecrypt = new CryptoStream(msDecrypt, decryptor, CryptoStreamMode.Read))
        using (MemoryStream plainStream = new MemoryStream())
        {
            csDecrypt.CopyTo(plainStream);
            return Encoding.UTF8.GetString(plainStream.ToArray());
        }
    }
}

额外注意事项 #

• 不要依赖异常消息文本判断错误类型，不同.NET版本或语言文化下，异常消息可能不同
• 加密和解密的所有参数（密钥、IV、模式、填充）必须完全一致，任何不匹配都会导致解密失败或错误

内容的提问来源于stack exchange，提问作者user21305001