NodeJS无法解密Java（AES/ECB/PKCS5Padding）加密结果问题排查

核心问题：密钥处理不匹配 #

Java和Node.js在AES密钥的字节转换逻辑上的差异，是导致解密失败或乱码的根本原因：

• Java中使用SecretKeySpec生成密钥时，会把密钥字符串按特定编码（如UTF-8、ISO-8859-1）转成字节数组；
• Node.js的crypto.createDecipheriv直接传字符串密钥时，默认按UTF-8转字节，若Java端用了其他编码，会导致密钥字节完全不匹配，要么解密报错，要么出乱码。

具体修复步骤 #

1. 对齐密钥编码逻辑 #

先确认客户Java代码的密钥转换方式：

• 如果Java代码是new SecretKeySpec("密钥字符串".getBytes("UTF-8"), "AES")，Node.js里就用UTF-8转Buffer；
• 如果是getBytes("ISO-8859-1")，Node.js对应用latin1编码（Node.js中ISO-8859-1的别名）转Buffer。

2. 修正Node.js代码 #

不要直接传字符串密钥，显式转换为Buffer，确保和Java端字节一致：

const crypto = require('crypto');

// 示例：假设Java端用UTF-8编码密钥，若为ISO-8859-1则替换成'latin1'
const keyBuffer = Buffer.from(ENC_KEY, 'utf8'); 

const decipher = crypto.createDecipheriv("aes-256-ecb", keyBuffer, null);
decipher.setAutoPadding(true); // Java默认用PKCS5Padding，和Node.js的PKCS7Padding在16字节块下完全兼容，不需要关闭

try {
  let deciphered = decipher.update(encryptedValue, "base64", "utf8");
  deciphered += decipher.final("utf8");
  console.log(deciphered);
} catch (err) {
  console.error("解密失败：", err);
}

3. 额外排查点 #

• 密钥长度校验：AES-256要求密钥是32字节（256位），如果Java端的密钥字符串转字节后不足32字节，可能有补全/截断逻辑，要和客户确认；
• 明文编码：如果Java加密时用了GBK等非UTF-8编码转明文字节，Node.js解密后要用对应编码转换（比如先转成binary再转GBK）；
• 加密模式一致性：确认Java端确实是ECB模式（Cipher.getInstance("AES/ECB/PKCS5Padding")），如果是CBC模式，还需要传入对应IV。

为什么关自动填充会出乱码？ #

关闭autoPadding只是跳过了填充字节的验证和移除，但如果密钥本身不匹配，解密出来的原始字节就是错误的，转成UTF-8自然是乱码，本质还是密钥问题。

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