C# AES跨机器加解密报错：last block incomplete in decryption

错误原因 #

"last block incomplete in decryption" 错误本质是解密时的密文长度不是AES块大小（16字节）的整数倍，通常由加密流程不规范、密钥/IV处理不一致或密文传输损坏导致。你的代码存在以下核心问题：

1. 加密时未完成最终块处理
   StreamWriter的using块会自动关闭，但CryptoStream在Write模式下，必须显式调用FlushFinalBlock()确保最后一块加密数据（含填充）被写入内存流。缺失这一步会导致密文截断，跨机器环境下缓存差异会让这个问题显现。

2. 硬编码全0IV的隐性风险
   虽然全0IV不会直接引发跨机器错误，但AES要求IV随机唯一（相同密钥下），且硬编码IV可能在不同环境中因默认配置差异引发兼容性问题。

3. 密钥长度未标准化
   如果_appSettings.JwtSecret的UTF8字节长度不是AES支持的标准长度（16/24/32字节对应128/192/256位），不同.NET环境的密钥处理逻辑可能不一致，导致实际加密密钥和解密密钥不匹配。

修正后的代码 #

加密方法 #

public string Encrypt1(string plainText)
{
    string key = _appSettings.JwtSecret;
    // 生成随机IV（AES要求IV必须唯一）
    byte[] iv = new byte[16];
    using (var rng = RandomNumberGenerator.Create())
    {
        rng.GetBytes(iv);
    }

    byte[] encryptedBytes;

    using (Aes aes = Aes.Create())
    {
        // 标准化密钥：通过SHA256将任意长度密钥转为32字节（256位），符合AES要求
        byte[] keyBytes;
        using (var sha256 = SHA256.Create())
        {
            keyBytes = sha256.ComputeHash(Encoding.UTF8.GetBytes(key));
        }
        aes.Key = keyBytes;
        aes.IV = iv;
        // 显式指定模式和填充，避免环境默认值差异
        aes.Mode = CipherMode.CBC;
        aes.Padding = PaddingMode.PKCS7;

        ICryptoTransform encryptor = aes.CreateEncryptor(aes.Key, aes.IV);

        using (MemoryStream memoryStream = new MemoryStream())
        {
            // 将IV写入密文开头，解密时需要读取
            memoryStream.Write(iv, 0, iv.Length);
            using (CryptoStream cryptoStream = new CryptoStream(memoryStream, encryptor, CryptoStreamMode.Write))
            {
                using (StreamWriter streamWriter = new StreamWriter(cryptoStream))
                {
                    streamWriter.Write(plainText);
                }
                // 强制完成最后一块加密数据的写入
                cryptoStream.FlushFinalBlock();
            }
            encryptedBytes = memoryStream.ToArray();
        }
    }

    return Convert.ToBase64String(encryptedBytes);
}

解密方法 #

public string Decrypt1(string cipherText)
{
    string key = _appSettings.JwtSecret;
    byte[] cipherBytes = Convert.FromBase64String(cipherText);

    using (Aes aes = Aes.Create())
    {
        // 与加密流程一致的密钥处理
        byte[] keyBytes;
        using (var sha256 = SHA256.Create())
        {
            keyBytes = sha256.ComputeHash(Encoding.UTF8.GetBytes(key));
        }
        aes.Key = keyBytes;
        aes.Mode = CipherMode.CBC;
        aes.Padding = PaddingMode.PKCS7;

        // 从密文开头读取IV（前16字节）
        byte[] iv = new byte[16];
        Array.Copy(cipherBytes, 0, iv, 0, iv.Length);
        aes.IV = iv;

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

        // 跳过IV，解密剩余密文部分
        using (MemoryStream memoryStream = new MemoryStream(cipherBytes, iv.Length, cipherBytes.Length - iv.Length))
        {
            using (CryptoStream cryptoStream = new CryptoStream(memoryStream, decryptor, CryptoStreamMode.Read))
            {
                using (StreamReader streamReader = new StreamReader(cryptoStream))
                {
                    return streamReader.ReadToEnd();
                }
            }
        }
    }
}

关键修改说明 #

• 强制调用FlushFinalBlock()：确保加密时所有数据（包括最后一块填充数据）被完整写入，避免密文截断。
• 随机IV与密文绑定：IV不需要保密，但必须与加密时一致，将其附加在密文开头，确保跨机器解密时能获取正确IV。
• 标准化密钥处理：通过SHA256哈希将任意长度的密钥转为32字节，消除不同环境下的密钥长度兼容性问题。
• 显式指定加密参数：明确CipherMode和PaddingMode，避免不同.NET版本的默认值差异导致逻辑不一致。

额外排查建议 #

• 确认两台机器的_appSettings.JwtSecret完全一致，包括大小写、特殊字符（需保证UTF8编码字节完全相同）。
• 检查加密后的Base64字符串在传输过程中是否被修改（如添加换行、空格或截断），可对比加密和解密前后的密文字节长度。

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