PHP转NodeJS：AES-256-CBC加解密函数适配问题排查

核心问题分析 #

问题1：解密现有加密串时strippading匹配失败/乱码 #

• NodeJS解密时直接将二进制结果转成UTF-8字符串，导致PKCS#7填充的控制字符（如\x01-\x10）被替换为�，无法正确识别填充长度。
• 原strippading函数未转义正则特殊字符（如.、*），导致匹配逻辑失效。

问题2：NodeJS与PHP加密结果不一致 #

• 虽然两者默认都使用PKCS#7填充，但转码流程存在差异：PHP先输出原始加密二进制再Base64编码，NodeJS直接输出Base64，若未统一buffer处理，可能因字符编码差异导致结果不同。
• 密钥/IV的编码未对齐：PHP默认用字符串原始字节，NodeJS若未显式指定编码，可能默认用UTF-8转buffer，导致字节不一致。

修复后的NodeJS代码 #

const crypto = require('crypto');

// 加密：对齐PHP流程，先得到加密buffer再转Base64
const encrypt = (data, key, iv) => {
    // 确保密钥、IV的编码和PHP一致（示例用utf8，若PHP用latin1则改为'latin1'）
    const keyBuffer = Buffer.from(key, 'utf8');
    const ivBuffer = Buffer.from(iv, 'utf8');
    const cipher = crypto.createCipheriv('AES-256-CBC', keyBuffer, ivBuffer);
    
    // 合并加密结果为buffer，再转Base64
    const encryptedBuffer = Buffer.concat([
        cipher.update(data, 'utf8'),
        cipher.final()
    ]);
    return encryptedBuffer.toString('base64');
}

// 解密：用buffer处理避免转码损坏，正确去除PKCS#7填充
const decrypt = (encryptedString, key, iv) => {
    try {
        const keyBuffer = Buffer.from(key, 'utf8');
        const ivBuffer = Buffer.from(iv, 'utf8');
        const decipher = crypto.createDecipheriv('AES-256-CBC', keyBuffer, ivBuffer);
        decipher.setAutoPadding(false); // 关闭自动填充，手动处理
        
        // 解密得到原始buffer
        const decryptedBuffer = Buffer.concat([
            decipher.update(encryptedString, 'base64'),
            decipher.final()
        ]);
        
        // 去除PKCS#7填充
        const strippedBuffer = removePkcs7Padding(decryptedBuffer);
        if (!strippedBuffer) throw new Error('Invalid padding format');
        
        // 转成UTF-8字符串返回
        return strippedBuffer.toString('utf8');
    } catch (e) {
        console.log(`解密失败：${e.message}`);
        return encryptedString;
    }
}

// 针对buffer实现PKCS#7填充去除，避免正则和编码问题
const removePkcs7Padding = (buffer) => {
    const paddingLength = buffer[buffer.length - 1];
    // 填充长度必须在1-16之间（AES块大小为16字节）
    if (paddingLength < 1 || paddingLength > 16) return null;
    
    // 验证所有填充字节是否等于填充长度
    for (let i = buffer.length - paddingLength; i < buffer.length; i++) {
        if (buffer[i] !== paddingLength) return null;
    }
    
    // 截取有效数据部分
    return buffer.slice(0, buffer.length - paddingLength);
}

关键修复说明 #

1. 加密流程对齐：NodeJS先将加密结果合并为buffer再转Base64，和PHPopenssl_encrypt返回原始二进制后base64_encode的逻辑完全一致。
2. buffer处理解密：直接操作原始二进制buffer，避免UTF-8转码损坏填充字符，彻底解决strippading匹配失败问题。
3. 可靠的填充去除：用buffer直接检查填充字节，无需处理正则转义，比字符串正则匹配更稳定。
4. 编码一致性：显式指定密钥、IV和输入数据的编码，确保和PHP的字节处理逻辑完全对齐。

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