NodeJS可恢复式密码加密最佳实践咨询（含代码问题）

兄弟，你的核心问题其实是对IV（初始化向量）的使用方式理解有点偏差——IV不需要在服务启动时全局生成并复用，反而每次加密都应该用新的IV，然后把IV和密文一起存储，这样就算服务重启，只要密钥不变，就能通过存储的IV解密之前的密文。

为什么当前方案会失败？ #

你现在把IV设成服务启动时随机生成的全局变量，一旦服务重启，新的IV就和之前加密时用的IV不一样了。AES-CBC模式下，解密必须使用和加密完全相同的IV，否则根本解不出正确内容，而且全局复用IV本身也不符合加密安全最佳实践（会增加被破解的风险）。

正确的实现思路 #

1. 每次加密生成独立IV：每次调用加密函数时，都生成一个新的16字节IV（因为AES-256-CBC要求IV是16字节）。
2. 绑定IV和密文存储：把生成的IV转换成十六进制字符串，和加密后的密文字符串一起保存（比如用一个特殊分隔符分开，或者存成包含iv和ciphertext的对象）。
3. 解密时拆分IV和密文：从存储的内容里取出IV和密文，分别转成Buffer后再进行解密操作。
4. 密钥安全管理：密钥绝对不能硬编码在代码里，要存在环境变量（比如process.env.ENCRYPTION_KEY）中，避免泄露。

修改后的代码实现 #

/* eslint-disable no-trailing-spaces */
const crypto = require('crypto');
const encryptionService = {
  encrypt: (data) => encrypt(data),
  decrypt: (data) => decrypt(data),
};

module.exports = encryptionService;

// Encryption details
const algorithm = 'aes-256-cbc';
// 从环境变量读取密钥，不要硬编码！
const secretKey = process.env.ENCRYPTION_KEY || 'fallback-secret-key'; // 生产环境一定要用环境变量

// 生成符合AES-256要求的32字节密钥
const key = crypto
  .createHash('sha256')
  .update(String(secretKey))
  .digest('base64')
  .substr(0, 32);

const encrypt = (data) => {
  // 每次加密都生成新的IV
  const iv = crypto.randomBytes(16);
  const cipher = crypto.createCipheriv(algorithm, Buffer.from(key), iv);
  let encrypted = cipher.update(data);
  encrypted = Buffer.concat([encrypted, cipher.final()]);
  
  // 将IV转成hex字符串，和密文hex用分隔符（比如::）拼接后返回
  return `${iv.toString('hex')}::${encrypted.toString('hex')}`;
};

const decrypt = (data) => {
  // 拆分出IV和密文
  const [ivHex, encryptedHex] = data.split('::');
  if (!ivHex || !encryptedHex) {
    throw new Error('Invalid encrypted data format');
  }
  
  const iv = Buffer.from(ivHex, 'hex');
  const encryptedText = Buffer.from(encryptedHex, 'hex');
  
  const decipher = crypto.createDecipheriv(algorithm, Buffer.from(key), iv);
  let decrypted = decipher.update(encryptedText);
  decrypted = Buffer.concat([decrypted, decipher.final()]);
  
  return decrypted.toString();
};

关键细节说明 #

• IV的存储：用::作为分隔符是因为十六进制字符里不会出现这个符号，拆分的时候不会出错。你也可以选择把IV和密文存成JSON对象（比如JSON.stringify({ iv: ivHex, ciphertext: encryptedHex })），存储和解析更清晰。
• 密钥安全：生产环境一定要用环境变量管理密钥，比如用dotenv包加载.env文件，绝对不能把密钥提交到Git仓库里。
• 加密强度：AES-256-CBC是安全的加密算法，只要密钥不泄露，加上每次用新IV，基本能满足你的需求。

这样修改后，不管服务重启多少次，只要密钥不变，之前加密的密码都能正常解密，同时也遵循了加密安全的最佳实践。

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