使用Node.js crypto模块加密长字符串报unsupported state错误如何解决

你遇到的Error: Trying to add data in unsupported state报错和加密的字符串长度无关，问题出在代码中把cipher、decipher实例做了全局单例初始化。
Node.js的crypto模块中，AES加密/解密实例是一次性的：只要调用过一次final()方法，实例的状态就会被清空锁定，无法再调用update()处理新的加密/解密任务，所以哪怕你加密短字符串，第二次调用encrypt()方法也会触发同样的报错。

每次调用加密、解密方法时，重新生成对应的cipher、decipher实例即可，1200位长度的字符串完全在AES算法的处理能力范围内，不需要额外做分片处理。
修正后的代码如下：

import * as crypto from 'crypto';
import { APP_CONFIG } from "@app-config";
const algorithm = 'aes-256-cbc';
// 只提取全局固定的密钥和IV，不提前生成加密解密实例
const ENCRYPTION_KEY = Buffer.from(APP_CONFIG.ENCRYPTION.ENCRYPTION_KEY);
const IV = APP_CONFIG.ENCRYPTION.IV;

class cryptoHelper {
    constructor() {
        // 可选：初始化时校验密钥和IV长度符合算法要求
        if (ENCRYPTION_KEY.length !== 32) throw new Error('aes-256-cbc要求密钥长度为32字节');
        if (IV.length !== 16) throw new Error('aes-256-cbc要求IV长度为16字节');
    }

    encrypt(text) {
        // 每次加密都生成新的cipher实例
        const cipher = crypto.createCipheriv(algorithm, ENCRYPTION_KEY, IV);
        let encrypted = cipher.update(text);
        encrypted = Buffer.concat([encrypted, cipher.final()]);
        return encrypted.toString('hex');
    }

    decrypt(encryptedData) {
        // 每次解密都生成新的decipher实例
        const decipher = crypto.createDecipheriv(algorithm, ENCRYPTION_KEY, IV);
        let encryptedText = Buffer.from(encryptedData, 'hex');
        let decrypted = decipher.update(encryptedText);
        decrypted = Buffer.concat([decrypted, decipher.final()]);
        return decrypted.toString();
    }
}

export const CryptoHelper = new cryptoHelper();

如果你需要提升加密安全性，避免相同明文加密后得到相同密文，可以每次加密随机生成IV，将IV拼接在密文前一起存储，解密时先取出前16位作为IV即可，IV不需要保密，示例如下：

encrypt(text) {
    // 每次生成随机16字节IV
    const randomIV = crypto.randomBytes(16);
    const cipher = crypto.createCipheriv(algorithm, ENCRYPTION_KEY, randomIV);
    let encrypted = cipher.update(text);
    encrypted = Buffer.concat([randomIV, encrypted, cipher.final()]);
    return encrypted.toString('hex');
}

decrypt(encryptedData) {
    const encryptedBuffer = Buffer.from(encryptedData, 'hex');
    // 前16位是本次加密使用的IV
    const iv = encryptedBuffer.subarray(0, 16);
    const encryptedText = encryptedBuffer.subarray(16);
    const decipher = crypto.createDecipheriv(algorithm, ENCRYPTION_KEY, iv);
    let decrypted = decipher.update(encryptedText);
    decrypted = Buffer.concat([decrypted, decipher.final()]);
    return decrypted.toString();
}

• 加密access_token、refresh_token这类敏感信息时，建议做好密钥的安全存储，不要硬编码在代码中，尽量通过环境变量、配置中心等加密渠道注入
• 如果需要加密的内容长度超过10KB，可以考虑将加密后的内容做base64编码替代hex编码，能减少存储占用

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