Node.js中加密含\t、\r、\n的字符串时特殊字符丢失的解决方法咨询

嘿，这个问题我之前处理带格式的文本加密时也踩过坑！问题的核心是你直接将字符串传递给cipher.update()时，虽然默认用UTF-8编码，但如果没有明确处理字符串到字节流的转换，某些控制字符（比如\t、\n、\r）可能在隐式转换环节被“遗漏”——本质是这些字符没有被正确映射为加密所需的字节，导致最终加密结果丢失了它们的信息。

修复方案：明确处理字符串与Buffer的转换 #

要确保所有字符（包括控制字符）都被完整加密，你需要先把字符串转换成标准的Buffer，再传递给加密函数。这样能保证每个字符都被转换成对应的UTF-8字节，不会丢失任何细节。

修改后的代码如下：

const crypto = require('crypto'); // 别忘了引入crypto模块！

module.exports.crypt = async ({ secretKey, ivKey }, data) => { 
  const encryptedData = {}; 
  for (const key in data) { 
    // 显式将字符串转为UTF-8 Buffer，确保控制字符被完整保留
    const inputBuffer = Buffer.from(data[key], 'utf8');
    const cipher = crypto.createCipheriv('aes-256-cbc', secretKey, ivKey);
    // 直接传入Buffer进行加密，避免编码歧义
    let encrypted = cipher.update(inputBuffer); 
    encrypted = Buffer.concat([encrypted, cipher.final()]); 
    encryptedData[key] = encrypted.toString('base64'); 
  } 
  return encryptedData; 
};

配套解密逻辑（确保还原特殊字符） #

为了形成完整的加密解密闭环，这里补充对应的解密代码，保证解密后能正确还原所有控制字符：

module.exports.decrypt = async ({ secretKey, ivKey }, encryptedData) => {
  const decryptedData = {};
  for (const key in encryptedData) {
    const encryptedBuffer = Buffer.from(encryptedData[key], 'base64');
    const decipher = crypto.createDecipheriv('aes-256-cbc', secretKey, ivKey);
    let decrypted = decipher.update(encryptedBuffer);
    decrypted = Buffer.concat([decrypted, decipher.final()]);
    // 将Buffer转回UTF-8字符串，控制字符会被精准还原
    decryptedData[key] = decrypted.toString('utf8');
  }
  return decryptedData;
};

为什么这样能解决问题？ #

• 显式转换为Buffer能消除编码歧义：直接传字符串时，Node.js虽会默认转UTF-8，但在部分场景（比如外部输入的字符串、包含转义序列的文本）下可能出现字符映射错误，Buffer.from(str, 'utf8')会严格按照UTF-8规则将所有字符（包括\t、\n这类控制字符）转换成对应字节。
• 加密后的base64字符串会完整保留这些字节信息，解密时反向转换就能1:1还原原始字符串。

测试验证 #

你可以用这段代码验证效果：

const { crypt, decrypt } = require('./your-module-path');

async function testSpecialChars() {
  const keys = {
    secretKey: crypto.randomBytes(32), // AES-256需要32位密钥
    ivKey: crypto.randomBytes(16) // CBC模式需要16位初始向量
  };
  const testData = {
    text: 'test\testemployee\n第二行\r第三行'
  };
  
  const encrypted = await crypt(keys, testData);
  const decrypted = await decrypt(keys, encrypted);
  
  console.log('原始字符串:', JSON.stringify(testData.text));
  console.log('解密后字符串:', JSON.stringify(decrypted.text));
  // 两者输出完全一致即说明修复成功
}

testSpecialChars();

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