Java本地聊天客户端-服务器AES-128文件传输BadPaddingException问题

嘿，这个异常我在做Java加密文件传输的时候也碰到过好几次！BadPaddingException本质上是AES解密时发现最后一块数据的填充不符合预期，大概率是加密和解密的流程有不一致的地方，或者文件字节处理出了问题。我给你梳理几个最常见的排查方向和解决办法：

1. 加密/解密的算法参数必须完全一致 #

AES的工作模式、填充方式必须在加密端和解密端完全匹配，这是最容易踩的坑：

• 比如你加密时用的是AES/CBC/PKCS5Padding，解密时绝对不能写成AES/ECB/PKCS5Padding或者AES/CBC/NoPadding，哪怕差一个字母都不行。
• 如果用的是CBC模式（推荐用这个，比ECB安全），必须确保两端用的**初始化向量(IV)**完全相同。最好的做法是加密时生成一个随机的IV（用SecureRandom生成），然后把IV和加密后的文件字节一起发送给对方，解密时先提取IV再初始化Cipher。

举个正确的初始化示例：

// 加密端生成IV并初始化Cipher
Cipher encryptCipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
SecretKey aesKey = ...; // 你的AES密钥
byte[] iv = new byte[encryptCipher.getBlockSize()]; // AES块大小是16字节
new SecureRandom().nextBytes(iv);
IvParameterSpec ivSpec = new IvParameterSpec(iv);
encryptCipher.init(Cipher.ENCRYPT_MODE, aesKey, ivSpec);

// 把IV和加密数据拼接后发送（比如先传IV，再传加密后的文件字节）
byte[] encryptedFileBytes = encryptCipher.doFinal(fileBytes);
byte[] dataToSend = ByteBuffer.allocate(iv.length + encryptedFileBytes.length)
                              .put(iv)
                              .put(encryptedFileBytes)
                              .array();

解密端要先拆分IV和加密数据：

// 解密端提取IV并初始化Cipher
Cipher decryptCipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
byte[] receivedData = ...; // 收到的完整字节数组
byte[] iv = Arrays.copyOfRange(receivedData, 0, decryptCipher.getBlockSize());
byte[] encryptedFileBytes = Arrays.copyOfRange(receivedData, decryptCipher.getBlockSize(), receivedData.length);

IvParameterSpec ivSpec = new IvParameterSpec(iv);
decryptCipher.init(Cipher.DECRYPT_MODE, aesKey, ivSpec);
byte[] decryptedFileBytes = decryptCipher.doFinal(encryptedFileBytes);

2. 文件字节读取/写入必须完整 #

如果读取文件时没有一次性读全所有字节，或者发送/接收时截断了数据，解密时拿到的不是完整的加密块，就会触发填充异常。

错误的读取方式（可能读不全）：

// 错误示例：只调用一次read，大文件会读不全
byte[] fileBytes = new byte[(int) file.length()];
new FileInputStream(file).read(fileBytes);

正确的读取方式（循环读取直到读完）：

File file = fileChooser.getSelectedFile();
byte[] fileBytes;
try (FileInputStream fis = new FileInputStream(file)) {
    fileBytes = new byte[(int) file.length()];
    int totalRead = 0;
    int read;
    while ((read = fis.read(fileBytes, totalRead, fileBytes.length - totalRead)) != -1) {
        totalRead += read;
    }
}

如果是大文件，更推荐分块读写+分块加密，避免内存溢出，同时也能保证数据完整性：

// 分块加密示例
try (FileInputStream fis = new FileInputStream(sourceFile);
     FileOutputStream fos = new FileOutputStream(encryptedFile)) {
    byte[] buffer = new byte[8192]; // 8KB块大小，可调整
    int bytesRead;
    while ((bytesRead = fis.read(buffer)) != -1) {
        byte[] encryptedChunk = encryptCipher.update(buffer, 0, bytesRead);
        if (encryptedChunk != null) {
            fos.write(encryptedChunk);
        }
    }
    // 处理最后一块的填充
    byte[] finalChunk = encryptCipher.doFinal();
    if (finalChunk != null) {
        fos.write(finalChunk);
    }
}

3. 不要重复使用同一个Cipher对象处理多个文件 #

如果你的cipher2对象在加密完一个文件后没有重置，直接用来加密下一个文件，会导致Cipher内部的状态混乱，进而引发填充异常。每次加密新文件时，都应该重新初始化Cipher对象，或者调用cipher.init()重新设置加密模式、密钥和参数。

4. 确认密钥完全一致 #

虽然你的文本聊天功能正常，但文件传输时可能不小心用了不同的密钥？比如密钥的编码、转换过程中出了问题（比如把密钥转成字符串时用了错误的编码）。一定要确保加密文件用的AES密钥和解密端的密钥是完全相同的字节数组。

先从这几个方向排查，应该能解决问题！

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