AES/CBC/PKCS7加密：Java与Web Crypto API结果不一致问题

要让Web端加密结果和Java端一致，必须严格对齐两者的加密参数与流程，以下是核心差异点及修复方案：

1. 完全对齐PBKDF2密钥派生参数 #

Java的PBKDF2WithHmacSHA256参数必须和Web端一一对应，任何参数不匹配都会导致密钥不同：

• 迭代次数：比如Java用10000次，Web端deriveKey时必须传入相同数值
• 盐：确保Java中盐的字节数组与Web端完全一致（例如Java用"mySalt".getBytes(StandardCharsets.UTF_8)，Web端对应new TextEncoder().encode("mySalt")）
• 密钥长度：AES密钥长度（128/256位），Java派生的密钥长度要和Web端deriveKey的length参数匹配

Web端PBKDF2密钥派生示例代码：

async function deriveAesKey(password, salt, iterations, keyLength) {
  const passwordBytes = new TextEncoder().encode(password);
  const saltBytes = new TextEncoder().encode(salt);
  const baseKey = await crypto.subtle.importKey(
    "raw",
    passwordBytes,
    { name: "PBKDF2" },
    false,
    ["deriveKey"]
  );
  return crypto.subtle.deriveKey(
    {
      name: "PBKDF2",
      salt: saltBytes,
      iterations: iterations,
      hash: "SHA-256"
    },
    baseKey,
    { name: "AES-CBC", length: keyLength },
    true,
    ["encrypt"]
  );
}

2. 匹配IV的生成与拼接逻辑 #

Java中AES/CBC模式通常会将16字节IV前缀到密文前再做Base64编码（解密需要相同IV），而Web端若只输出加密后的密文字节，必然导致结果不一致。

修复方案：

1. 生成16字节随机IV（AES-CBC的IV固定为16字节，和Java的SecureRandom生成逻辑对齐）
2. 执行加密得到密文
3. 将IV和密文拼接成一个连续的字节数组
4. 对拼接后的数组做Base64编码

Web端加密示例代码：

async function encryptWithAesCbc(password, plaintext, salt, iterations, keyLength) {
  const aesKey = await deriveAesKey(password, salt, iterations, keyLength);
  // 生成16字节随机IV
  const iv = crypto.getRandomValues(new Uint8Array(16));
  const plaintextBytes = new TextEncoder().encode(plaintext);
  // 执行加密
  const ciphertextBuffer = await crypto.subtle.encrypt(
    { name: "AES-CBC", iv: iv },
    aesKey,
    plaintextBytes
  );
  // 拼接IV与密文
  const combinedBytes = new Uint8Array(iv.length + ciphertextBuffer.byteLength);
  combinedBytes.set(iv, 0);
  combinedBytes.set(new Uint8Array(ciphertextBuffer), iv.length);
  // 转标准Base64编码（与Java的Base64.getEncoder()对齐）
  return btoa(String.fromCharCode(...combinedBytes));
}

3. 对齐Base64编码规则 #

Java的Base64.getEncoder().encodeToString()使用标准Base64编码，Web端需确保：

• 不使用URL安全的Base64编码（避免Java用标准编码、Web端用URL编码的情况）
• 仅对IV+密文的组合字节数组做Base64编码，而非单独编码密文

4. 确认填充与字符编码 #

• AES/CBC填充：Java的PKCS7Padding与Web Cryptography API的默认填充（PKCS#7）完全一致，无需额外配置
• 明文编码：Java中需显式使用plaintext.getBytes(StandardCharsets.UTF_8)，Web端用new TextEncoder().encode(plaintext)，确保两者都用UTF-8编码明文

验证说明 #

将Java端的密码、盐、迭代次数、密钥长度等参数代入上述Web端代码，即可生成与Java端完全一致的Base64加密结果。

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