.NET Framework 4.5.2项目使用BouncyCastle实现AES-256/GCM/无填充时遇初始化参数无效异常

我帮你定位到了问题的核心——你遇到的invalid parameter passed to AES init异常，本质是因为初始化Cipher时使用的算法名称不匹配GCM模式的要求。BouncyCastle中，单纯的"AES"算法默认对应ECB模式的实现，它不接受GCM所需的AeadParameters参数，必须明确指定完整的算法模式和填充方式。

关键修改点 #

1. 修正算法名称：将常量ALGORITHM从"AES"改为"AES/GCM/NoPadding"，这是BouncyCastle识别AES-GCM无填充模式的标准名称。
2. 添加密钥长度校验：确保传入的密钥是256位（32字节），避免因密钥长度不符导致的潜在问题。
3. 明确GCM密文结构：GCM模式下，BouncyCastle的DoFinal会自动将认证标签附加在密文末尾，打包和解包逻辑要适配这一结构。

修正后的完整代码 #

using System;
using System.Text;
using System.Security.Cryptography;
using Org.BouncyCastle.Crypto;
using Org.BouncyCastle.Crypto.Parameters;
using Org.BouncyCastle.Security;

public class BouncyCastleCustom
{
    // 关键修改：指定完整的AES-GCM算法标识符
    private const string ALGORITHM = "AES/GCM/NoPadding";
    private const byte AesIvSize = 16;
    private const byte GcmTagSize = 16; // 128位标签，符合GCM最佳实践
    private readonly CipherMode _cipherMode = CipherMode.GCM;

    public string Encrypt(string plainText, byte[] key)
    {
        // 强制校验密钥长度为256位（32字节）
        if (key.Length != 32)
            throw new ArgumentException("密钥必须为256位（32字节）", nameof(key));

        var random = new SecureRandom();
        var iv = random.GenerateSeed(AesIvSize);
        var keyParameters = CreateKeyParameters(key, iv, GcmTagSize * 8);
        var cipher = CipherUtilities.GetCipher(ALGORITHM);
        cipher.Init(true, keyParameters);
        
        var plainTextData = Encoding.UTF8.GetBytes(plainText);
        // GCM模式下，DoFinal返回密文+认证标签的组合数据
        var cipherTextWithTag = cipher.DoFinal(plainTextData);
        return PackCipherData(cipherTextWithTag, iv);
    }

    public string Decrypt(string cipherText, byte[] key)
    {
        if (key.Length != 32)
            throw new ArgumentException("密钥必须为256位（32字节）", nameof(key));

        var (encryptedBytesWithTag, iv, tagSize) = UnpackCipherData(cipherText);
        var keyParameters = CreateKeyParameters(key, iv, tagSize * 8);
        var cipher = CipherUtilities.GetCipher(ALGORITHM);
        cipher.Init(false, keyParameters);
        
        var decryptedData = cipher.DoFinal(encryptedBytesWithTag);
        return Encoding.UTF8.GetString(decryptedData);
    }

    private ICipherParameters CreateKeyParameters(byte[] key, byte[] iv, int macSize)
    {
        var keyParameter = new KeyParameter(key);
        if (_cipherMode == CipherMode.CBC)
        {
            return new ParametersWithIV(keyParameter, iv);
        }
        else if (_cipherMode == CipherMode.GCM)
        {
            // GCM专用参数：包含密钥、标签长度、初始化向量
            return new AeadParameters(keyParameter, macSize, iv);
        }
        throw new NotSupportedException("不支持的加密模式");
    }

    private string PackCipherData(byte[] encryptedBytesWithTag, byte[] iv)
    {
        var dataSize = encryptedBytesWithTag.Length + iv.Length + 1;
        if (_cipherMode == CipherMode.GCM)
            dataSize += 1;
        
        var index = 0;
        var data = new byte[dataSize];
        data[index] = AesIvSize;
        index += 1;
        
        if (_cipherMode == CipherMode.GCM)
        {
            data[index] = GcmTagSize;
            index += 1;
        }
        
        Array.Copy(iv, 0, data, index, iv.Length);
        index += iv.Length;
        Array.Copy(encryptedBytesWithTag, 0, data, index, encryptedBytesWithTag.Length);
        return Convert.ToBase64String(data);
    }

    private (byte[] encryptedBytesWithTag, byte[] iv, byte tagSize) UnpackCipherData(string cipherText)
    {
        var index = 0;
        var cipherData = Convert.FromBase64String(cipherText);
        byte ivSize = cipherData[index];
        index += 1;
        
        byte tagSize = 0;
        if (_cipherMode == CipherMode.GCM)
        {
            tagSize = cipherData[index];
            index += 1;
        }
        
        byte[] iv = new byte[ivSize];
        Array.Copy(cipherData, index, iv, 0, ivSize);
        index += ivSize;
        
        byte[] encryptedBytesWithTag = new byte[cipherData.Length - index];
        Array.Copy(cipherData, index, encryptedBytesWithTag, 0, encryptedBytesWithTag.Length);
        return (encryptedBytesWithTag, iv, tagSize);
    }

    public enum CipherMode
    {
        CBC, GCM
    }
}

class Program
{
    static void Main(string[] args)
    {
        try
        {
            BouncyCastleCustom aes = new BouncyCastleCustom();
            // 示例密钥转UTF8后恰好为32字节（256位），生产环境建议用随机生成的密钥
            var key = Encoding.UTF8.GetBytes("mysmallkey1234551298765134567890");
            var encrypted = aes.Encrypt("testDemo", key);
            Console.WriteLine("Encrypted testDemo: " + encrypted);
            string decrypted = aes.Decrypt(encrypted, key);
            Console.WriteLine("Decrypted: " + decrypted);
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

额外注意事项 #

• IV的唯一性：GCM模式要求每次加密使用全新的IV（无需保密，但必须唯一），你的代码用SecureRandom.GenerateSeed生成是正确的，绝对不能重复使用IV。
• 密钥生成规范：生产环境中，不要用明文字符串转换生成密钥，应该用RNGCryptoServiceProvider生成随机32字节的密钥，避免字符编码导致的长度偏差。
• 标签长度：GCM标签建议使用128位（16字节），不要使用小于96位的标签，否则会降低安全性。

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