Rust AES-CBC解密报错：RustCrypto库出现UnpadError问题

核心原因 #

出现UnpadError的本质是填充处理的严格性差异：

• 废弃的rust-crypto库对PKCS填充的验证容错性高，甚至能兼容不符合标准的填充实现
• RustCrypto的pkcs7 crate严格遵循PKCS#7填充标准，而Java的AES/CBC/PKCS5Padding本质是PKCS#7填充（AES块大小为16字节，PKCS#5仅针对8字节块，Java的命名是历史遗留问题）。若Java端加密的填充不符合标准，或Rust端输入（密钥/IV/密文）存在不一致，就会触发该错误。

解决方案 #

1. 配置正确依赖 #

在Cargo.toml中添加维护中的RustCrypto生态依赖：

[dependencies]
aes = "0.8.3"
cbc = "0.1.2"
pkcs7 = "0.7.1"
base64 = "0.21.5" # 密文为Base64编码时需添加

2. 匹配Java端加密参数 #

确保以下参数完全对齐：

• IV必须是16字节全0数组（AES块大小）
• 密钥需与Java端一致：若Java用UTF-8转字节，Rust也用相同编码；若用Hex则对应hex::decode
• 密文解码需匹配Java的编码方式：Java通常用标准Base64，Rust需使用对应变体

3. 标准实现代码 #

use aes::Aes128; // 根据密钥长度选择Aes128/Aes192/Aes256
use cbc::cipher::{KeyIvInit, Decryptor, BlockDecryptMut};
use cbc::Cbc;
use pkcs7::Unpad;
use base64::engine::general_purpose::STANDARD as BASE64_STD;
use base64::Engine as _;

type AesCbcDecryptor = Decryptor<Cbc<Aes128>>;

fn decrypt_java_aes(ciphertext_b64: &str, key: &str) -> Result<String, Box<dyn std::error::Error>> {
    // 解码Base64密文（Java用其他编码时替换对应逻辑）
    let ciphertext = BASE64_STD.decode(ciphertext_b64)?;
    
    // 转换密钥为字节（Java用Hex则替换为hex::decode）
    let key_bytes = key.as_bytes();
    if ![16, 24, 32].contains(&key_bytes.len()) {
        return Err("密钥长度必须为16/24/32字节（对应AES-128/192/256）".into());
    }

    // 初始化CBC解密器，IV为16字节全0
    let iv = [0u8; 16];
    let mut decryptor = AesCbcDecryptor::new(key_bytes.into(), &iv.into());
    
    // 解密并处理PKCS#7填充
    let mut padded_plaintext = ciphertext.to_vec();
    decryptor.decrypt_blocks_mut(&mut padded_plaintext);
    let plaintext = padded_plaintext.unpad()?;
    
    // 转换为UTF-8字符串（明文非UTF-8时替换对应编码处理）
    Ok(String::from_utf8(plaintext)?)
}

排查调试步骤 #

1. 核对输入一致性：
   打印rust-crypto处理时的密钥、IV、密文字节数组，与RustCrypto的输入完全对比，排查编码或截断差异。
2. 验证填充合法性：
   用rust-crypto解密后查看明文末尾：PKCS#7标准要求最后n个字节的值都是n（n为1-16）。若Java端填充不符合该规则（比如填充全0），需修正Java加密逻辑；若无法修改Java端，可临时手动去除填充（仅应急）：

   // 仅确认填充为非标准全0时使用
   let last_byte = padded_plaintext.last().copied().unwrap_or(0);
   let plaintext = &padded_plaintext[..padded_plaintext.len() - last_byte as usize];
   

3. 检查密文长度：
   CBC模式密文必须是16字节的整数倍，若不是则说明密文解码错误或传输时被截断。

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