Node.js AES-256-CTR加密，Java解密乱码问题求助

我之前也踩过跨语言AES加密解密不一致的坑，这种乱码情况几乎都是Node.js和Java在几个关键实现细节上没对齐导致的，咱们一步步拆解排查：

核心问题点：跨语言实现的细节差异 #

AES-CTR属于流模式加密，本身不需要填充，但Node.js和Java的默认处理逻辑、编码方式很容易出现偏差，直接导致解密乱码。以下是最常见的几个坑：

1. 密钥/IV的字节一致性 #

这是最容易出错的环节：

• 密钥生成/解码：如果Node.js用crypto.scryptSync生成密钥，Java必须用完全相同的参数（盐、N/r/p值）和兼容库（比如BouncyCastle）生成；如果是固定密钥，Node.js用Buffer.from(keyHex, 'hex')转成字节数组，Java就要对应用Hex.decodeHex(keyHex.toCharArray())解码，确保两边密钥字节完全一致。
• IV的传递：AES-CTR的IV必须是16字节（128位），Node.js生成的IV要以Hex或Base64字符串形式传递给Java，绝对不能直接把IV的Buffer转成UTF-8字符串——因为IV是随机字节，转成UTF-8会丢失原始字节信息。

2. Cipher模式与填充设置 #

• Node.js的crypto.createCipheriv('aes-256-ctr', key, iv)默认无填充（CTR模式不需要填充），所以Java里必须明确指定AES/CTR/NoPadding，如果省略NoPadding，Java会默认使用PKCS5Padding，这会直接导致解密后出现乱码或报错。
• 确保Java的Cipher实例初始化时，使用解密模式（Cipher.DECRYPT_MODE），并正确传入SecretKeySpec和IvParameterSpec。

3. 加密输出与解密输入的编码对齐 #

Node.js加密后通常输出Hex或Base64字符串，Java解密前必须先将字符串解码成字节数组：

• 如果Node.js用cipher.update(data, 'utf8', 'hex') + cipher.final('hex')输出Hex，Java要用Hex.decodeHex(encryptedStr.toCharArray())解码。
• 如果是Base64输出，Java要用Base64.getDecoder().decode(encryptedStr)解码。

代码示例对比 #

Node.js 加密代码（兼容Java版） #

const crypto = require('crypto');

// 生成256位密钥（生产环境建议用固定密钥Hex，避免scrypt参数不一致）
const password = 'your-secret-password';
const salt = Buffer.from('your-fixed-salt', 'utf8');
const key = crypto.scryptSync(password, salt, 32, { N: 16384, r: 8, p: 1 });

// 生成16字节IV
const iv = crypto.randomBytes(16);

// 加密并输出Hex格式结果
const cipher = crypto.createCipheriv('aes-256-ctr', key, iv);
let encrypted = cipher.update('需要加密的内容', 'utf8', 'hex');
encrypted += cipher.final('hex');

// 输出用于Java解密的参数（生产环境不要泄露密钥）
console.log('加密结果(Hex):', encrypted);
console.log('IV(Hex):', iv.toString('hex'));
console.log('密钥(Hex):', key.toString('hex'));

对应Java 解密代码 #

import javax.crypto.Cipher;
import javax.crypto.spec.IvParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import org.apache.commons.codec.binary.Hex;

public class AESCTRDecrypt {
    public static void main(String[] args) throws Exception {
        // 替换为Node.js输出的加密结果、IV、密钥Hex
        String encryptedHex = "your-encrypted-hex-string";
        String ivHex = "your-iv-hex-string";
        String keyHex = "your-key-hex-string";

        // 解码密钥、IV、加密字节
        byte[] key = Hex.decodeHex(keyHex.toCharArray());
        byte[] iv = Hex.decodeHex(ivHex.toCharArray());
        byte[] encryptedBytes = Hex.decodeHex(encryptedHex.toCharArray());

        // 初始化Cipher，必须指定CTR和NoPadding
        Cipher cipher = Cipher.getInstance("AES/CTR/NoPadding");
        SecretKeySpec keySpec = new SecretKeySpec(key, "AES");
        IvParameterSpec ivSpec = new IvParameterSpec(iv);
        cipher.init(Cipher.DECRYPT_MODE, keySpec, ivSpec);

        // 解密并转成UTF-8字符串
        byte[] decryptedBytes = cipher.doFinal(encryptedBytes);
        String decryptedContent = new String(decryptedBytes, "UTF-8");
        System.out.println("解密结果: " + decryptedContent);
    }
}

排查步骤（按优先级） #

1. 验证密钥字节一致性：把Node.js输出的密钥Hex在Java中解码，对比两边的字节数组是否完全相同。
2. 验证IV字节一致性：同样对比Node.js和Java中的IV字节数组。
3. 验证加密字节一致性：Node.js将加密后的Hex转成Buffer，Java将加密Hex转成字节数组，对比是否一致。
4. 检查Java的Cipher模式：确认是AES/CTR/NoPadding，没有使用默认填充。
5. 检查字符串编码：解密后的字节转字符串时，必须用UTF-8，和Node.js加密时的编码一致。

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