C# URL安全AES加密异常：解密失败或报‘输入数据块不完整’错误

1. 原实现无法正常工作的原因 #

• 二进制密文转UTF8字符串导致数据损坏：加密生成的是二进制字节流，这些字节并非合法的UTF8编码序列，强行用Encoding.UTF8.GetString转换为字符串时，会丢失或篡改原始二进制数据。后续再将该字符串转回字节解密时，数据已经不完整或错误，最终导致解密失败或出现乱码。
• 未正确完成加密流的写入：CryptoStream在写入数据后需要确保所有缓存的加密数据都写入到目标流，原代码未处理加密流的最终刷新操作，会导致最后一块加密数据缺失，解密时触发“输入数据块不完整”异常。
• Key和IV使用全空字节数组：这不仅严重违反安全规范，CBC模式要求IV必须随机（不需要保密但要唯一），固定空IV会大幅降低加密安全性，同时空密钥等于没有加密保护。
• 解密流程的输入错误：原Decrypt方法将传入的损坏字符串直接转成UTF8字节当作加密密文，但该字符串本身是二进制转UTF8的错误结果，并非原始加密字节，自然无法正确解密。

2. 更优的实现方式 #

以下是修正后的安全实现，适配URL传输场景，解决了上述所有问题：

using System;
using System.IO;
using System.Security.Cryptography;
using System.Text;

public static class StringCipher
{
    // 注意：实际使用中请使用安全密钥，可通过密码派生（如Rfc2898DeriveBytes）或随机生成后安全存储
    private static readonly byte[] _key = Encoding.UTF8.GetBytes("your_secure_16_byte_key"); // 16字节对应AES-128

    public static string Encrypt(string plainText)
    {
        if (string.IsNullOrEmpty(plainText))
            throw new ArgumentNullException(nameof(plainText));

        using var aes = Aes.Create();
        aes.Key = _key;
        aes.GenerateIV(); // 生成随机IV
        aes.Mode = CipherMode.CBC;
        aes.Padding = PaddingMode.PKCS7; // 使用标准安全填充

        byte[] encryptedBytes;
        using (var encryptor = aes.CreateEncryptor(aes.Key, aes.IV))
        using (var ms = new MemoryStream())
        {
            using (var cs = new CryptoStream(ms, encryptor, CryptoStreamMode.Write))
            using (var sw = new StreamWriter(cs))
            {
                sw.Write(plainText);
            }
            encryptedBytes = ms.ToArray();
        }

        // 合并IV和密文：IV在前，解密时分离
        byte[] result = new byte[aes.IV.Length + encryptedBytes.Length];
        Buffer.BlockCopy(aes.IV, 0, result, 0, aes.IV.Length);
        Buffer.BlockCopy(encryptedBytes, 0, result, aes.IV.Length, encryptedBytes.Length);

        // 直接生成URL安全的Base64编码
        return Convert.ToBase64String(result).Replace('+', '-').Replace('/', '_').TrimEnd('=');
    }

    public static string Decrypt(string encryptedText)
    {
        if (string.IsNullOrEmpty(encryptedText))
            throw new ArgumentNullException(nameof(encryptedText));

        // 还原标准Base64格式
        string base64 = encryptedText.Replace('-', '+').Replace('_', '/');
        base64 = base64.PadRight(base64.Length + (4 - base64.Length % 4) % 4, '=');

        byte[] combinedBytes = Convert.FromBase64String(base64);
        using var aes = Aes.Create();
        aes.Key = _key;
        aes.Mode = CipherMode.CBC;
        aes.Padding = PaddingMode.PKCS7;

        // 分离IV和密文：前16字节为AES-128的固定IV长度
        byte[] iv = new byte[16];
        byte[] encryptedBytes = new byte[combinedBytes.Length - iv.Length];
        Buffer.BlockCopy(combinedBytes, 0, iv, 0, iv.Length);
        Buffer.BlockCopy(combinedBytes, iv.Length, encryptedBytes, 0, encryptedBytes.Length);

        aes.IV = iv;
        string plainText;
        using (var decryptor = aes.CreateDecryptor(aes.Key, aes.IV))
        using (var ms = new MemoryStream(encryptedBytes))
        using (var cs = new CryptoStream(ms, decryptor, CryptoStreamMode.Read))
        using (var sr = new StreamReader(cs))
        {
            plainText = sr.ReadToEnd();
        }

        return plainText;
    }
}

优化点说明 #

• 直接适配URL传输：加密后直接生成URL安全的Base64字符串，跳过二进制转UTF8的错误步骤，避免数据损坏。
• 随机IV机制：每次加密生成独立随机IV，并与密文合并传输，符合CBC模式的安全要求。
• 标准加密流处理：使用StreamWriter自动处理流的刷新与关闭，确保所有明文都被完整加密。
• 安全填充方式：采用PKCS7标准填充，避免Zeros填充带来的明文末尾截断问题。
• 密钥安全提示：示例中使用固定密钥仅作演示，实际场景需使用密码派生或专业密钥管理方案，禁止使用空密钥或弱密钥。

使用示例 #

// 加密生成URL参数
var encrypted = StringCipher.Encrypt("my payload");
var url = $"https://example.com?code={encrypted}";

// 从URL解密
var code = "从URL参数中获取的加密字符串";
var plainText = StringCipher.Decrypt(code); // 得到"my payload"

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