Node.js crypto模块AES-256-CBC加解密及URL安全编码问题

疑问1：IV的处理方式及必要性 #

• 必须使用随机IV：AES-CBC模式下，初始化向量（IV）是必需的，且每次加密都要生成随机IV。如果固定IV，相同明文和密钥会生成完全一致的密文，攻击者可通过密文重复推断明文信息，大幅降低加密安全性。
• IV与密文的结合方式：IV无需加密（本身无敏感信息），只需和密文一同传递给解密端即可。常用做法：
  1. 将随机生成的IV转为URL安全的Base64字符串；
  2. 用分隔符（如.）拼接IV的Base64字符串与加密后的密文Base64字符串；
  3. 对拼接结果做URL安全处理（或分别处理后再拼接）。

疑问2：Base64使用正确性 #

你在encrypt函数里的Base64参数使用是正确的：cipher.update(text, 'utf8', 'base64')和cipher.final('base64')能直接把二进制加密结果转成Base64字符串。但代码存在一处错误：你引用了未定义的result变量，应替换为encrypted。

另外，解密时需注意：URL安全Base64去掉了=填充符，解密前要补回=（Base64字符串长度必须是4的倍数，不足时补=），否则Base64解码会失败。

修正后的完整代码 #

import crypto from 'node:crypto';

function encrypt(text) {
  const iv = crypto.randomBytes(16);
  const cipher = crypto.createCipheriv(
    'aes-256-cbc',
    Buffer.from(process.env.SECRET_KEY!),
    iv
  );
  
  // 将明文加密为Base64字符串
  let encrypted = cipher.update(text, 'utf8', 'base64');
  encrypted += cipher.final('base64');
  
  // 将IV转为URL安全Base64，与密文拼接
  const ivBase64 = iv.toString('base64')
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=/g, '');
  const encryptedBase64 = encrypted
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=/g, '');
  
  // 用分隔符拼接IV和密文，方便解密时拆分
  return `${ivBase64}.${encryptedBase64}`;
}

function decrypt(encryptedText) {
  // 拆分IV和密文
  const [ivBase64, encryptedBase64] = encryptedText.split('.');
  
  // 恢复标准Base64格式（补回=）
  const ivStandardBase64 = ivBase64.replace(/-/g, '+').replace(/_/g, '/') + '=='.slice((ivBase64.length * 3) % 4);
  const encryptedStandardBase64 = encryptedBase64.replace(/-/g, '+').replace(/_/g, '/') + '=='.slice((encryptedBase64.length * 3) % 4);
  
  // 解码IV和密文为Buffer
  const iv = Buffer.from(ivStandardBase64, 'base64');
  const encryptedBuffer = Buffer.from(encryptedStandardBase64, 'base64');
  
  // 创建解密器并解密
  const decipher = crypto.createDecipheriv(
    'aes-256-cbc',
    Buffer.from(process.env.SECRET_KEY!),
    iv
  );
  
  let decrypted = decipher.update(encryptedBuffer);
  decrypted = Buffer.concat([decrypted, decipher.final()]);
  
  // 转成UTF8字符串返回
  return decrypted.toString('utf8');
}

补充说明 #

• 密钥要求：AES-256需要32字节（256位）的密钥，确保process.env.SECRET_KEY是32字节长度的字符串，否则Buffer.from会自动截断或补全，导致解密失败。
• 异常处理：实际使用中建议添加try/catch块，处理加密解密过程中的异常（如密钥长度错误、密文格式错误等）。

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