将PHP AES-256-CBC加密逻辑转换为Node.js实现的方法

原PHP逻辑拆解 #

先把原代码的执行步骤梳理清楚，逐段对齐即可：

• 固定使用16字节IV值：PJKKIOKDOICIVSPC，符合AES-CBC的IV长度要求
• 对输入明文手动做PKCS5填充（AES块长固定16字节，该填充逻辑和PKCS7填充完全一致）
• 调用openssl_encrypt时传入OPENSSL_ZERO_PADDING参数，作用是关闭openssl默认自动启用的PKCS填充，而非使用零填充，和手动填充的逻辑匹配
• 将openssl返回的base64格式密文解码为二进制
• 把二进制密文转换为十六进制字符串
• 对十六进制字符串做URL编码后作为结果返回

容易踩的对齐坑 #

• 不要在Node.js侧启用crypto模块默认的自动填充，否则会因为重复填充导致密文不匹配
• 注意密钥、IV的编码要和PHP侧完全一致，两侧都用相同编码的字符串转二进制即可
• Node.js的crypto加密接口直接输出二进制Buffer，不需要额外做base64解码步骤，和PHP侧base64解码后的结果是等价的

等效Node.js代码 #

直接使用Node.js内置的crypto和querystring模块，无需安装第三方依赖：

const crypto = require('crypto');
const querystring = require('querystring');

// 对齐原PHP的pkcs5_pad函数
function pkcs5Pad(textBuf) {
    const blockSize = 16;
    const padLength = blockSize - (textBuf.length % blockSize);
    const padBuffer = Buffer.alloc(padLength, padLength);
    return Buffer.concat([textBuf, padBuffer]);
}

// 对齐原PHP的encryptAES函数
function encryptAES(plainText, key) {
    const fixedIv = 'PJKKIOKDOICIVSPC';
    // 明文转Buffer后做手动填充
    const paddedPlain = pkcs5Pad(Buffer.from(plainText, 'utf8'));
    // 初始化加密器，关闭自动填充
    const cipher = crypto.createCipheriv(
        'aes-256-cbc',
        Buffer.from(key),
        Buffer.from(fixedIv, 'utf8')
    );
    cipher.setAutoPadding(false);
    // 执行加密得到二进制密文
    const encryptedBuffer = Buffer.concat([cipher.update(paddedPlain), cipher.final()]);
    // 转十六进制后做URL编码返回
    const hexCipher = encryptedBuffer.toString('hex');
    return querystring.escape(hexCipher);
}

验证说明 #

如果两侧输出结果不一致，优先排查：

• 传入的密钥内容、编码是否完全一致，若PHP侧密钥是二进制/十六进制格式，Node.js侧转Buffer时需要对应调整编码参数
• 原PHP代码中$iv = "PJKKIOKDOICIVSPC"行末尾缺少分号，属于书写笔误，运行前需要补全

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