Node.js基于crypto实现与ColdFusion兼容AES加密的解密异常排查
加密方法修正方案
问题根因
- 现有解密逻辑已经和ColdFusion输出格式做了对齐,约定密文字符串的结构为:前16字节(HEX编码下对应前32个字符)为CBC模式必需的初始化向量IV,后续部分为实际加密后的密文内容,这也是ColdFusion AES/CBC/PKCS5Padding加密的默认输出结构。
- 原有加密方法的核心缺陷:仅返回了加密后的纯密文HEX内容,没有把随机生成的16字节IV拼接到密文前面。这导致解密时会把全部密文内容切分为IV和“密文部分”,最终拿到的有效密文长度为0,不符合AES分组加密的块长度要求,触发
wrong final block length报错。 - 从测试输出可以直接印证问题:加密返回的
fdcec1c7098c0fc91a11ada1e849b543只有32个HEX字符(共16字节),刚好等于IV的长度,解密时切完IV后没有剩余的密文数据,必然解密失败。
修正后的完整代码
只需要调整加密方法的返回逻辑,把IV和加密内容拼接为整体后再转HEX即可,修正后的类代码如下:
const crypto = require('crypto'); const key = Buffer.from('nQw7y6QejwGFh/SNrul20Q==', 'base64'); module.exports = class Encrypt { decryptText(text) { try { const ivCiphertext = Buffer.from(text, 'hex'); const iv = ivCiphertext.slice(0, 16); const ciphertext = ivCiphertext.slice(16); const decipher = crypto.createDecipheriv('AES-128-CBC', key, iv); const value = decipher.update(ciphertext, '', 'utf8') + decipher.final('utf8'); return value; } catch (err) { console.log(err); } } encrypt(text) { try { // 生成CBC模式要求的16字节随机IV const iv = crypto.randomBytes(16); const cipher = crypto.createCipheriv('AES-128-CBC', key, iv); // 显式指定输入编码为UTF-8,避免多语言场景下的编码兼容问题 let encryptedContent = cipher.update(text, 'utf8'); encryptedContent = Buffer.concat([encryptedContent, cipher.final()]); // 核心修正:按ColdFusion的输出结构,将IV拼接到加密内容前 const fullCipherBuffer = Buffer.concat([iv, encryptedContent]); // 转HEX编码输出,和ColdFusion的输出格式完全一致 return fullCipherBuffer.toString('hex'); } catch (err) { console.log(err); } } };
效果验证
修正后运行原测试用例:
- 加密生成的HEX字符串长度将符合结构要求:16字节IV(32个HEX字符) + 文本加密后的内容(按PKCS5Padding填充到AES块大小的整数倍)
- 调用现有
decryptText方法可以正常还原明文,不会触发块长度错误 - 生成的密文可以直接被ColdFusion侧的
decrypt函数正常解密,实现双向兼容
内容的提问来源于stack exchange,提问作者myTest532 myTest532
相关产品推荐
相关产品推荐

