NodeJS解密Golang加密的AES-256-GCM图片遇认证错误求助

核心错误原因分析 #

出现Error: Unsupported state or unable to authenticate data的问题，核心集中在GCM模式参数不匹配和NodeJS解密流程缺失关键步骤，具体包括：

1. NodeJS未设置GCM认证标签（最关键） #

GCM模式要求解密时必须传入加密生成的认证标签（Tag）验证数据完整性，你的NodeJS代码完全漏掉了decipher.setAuthTag(tag)这一步，这是导致认证失败的直接原因。

2. Nonce/IV与Tag长度不匹配 #

Golang中AES-GCM默认Nonce长度为12字节（gcm.NonceSize()返回值），默认Tag长度为16字节。如果NodeJS中IV_SIZE和TAG_SIZE不是这两个值，会导致截取的IV、密文、Tag完全错误。且你的代码未定义这两个常量，进一步加剧参数混乱。

3. 密钥生成不一致 #

Golang中createHash(passphrase)需生成AES-256要求的32字节密钥，NodeJS中encryptedKey(enc_key)返回的密钥必须满足：

• 哈希算法与Golang的createHash一致（比如均为SHA-256）
• 编码格式匹配（Golang用哈希结果的[]byte，NodeJS需返回32字节的Buffer类型）

4. NodeJS代码存在语法错误 #

代码中有一行多余的右括号：

decipher.update(encryptedData, 'null', 'binary') + decipher.final('binary'));

该语法错误会干扰解密流程正常执行。

修正后的代码及步骤 #

第一步：确认Golang端哈希实现 #

确保createHash生成符合AES-256要求的32字节密钥，示例如下：

import "crypto/sha256"

func createHash(passphrase string) []byte {
    h := sha256.New()
    h.Write([]byte(passphrase))
    return h.Sum(nil) // 直接返回32字节的哈希字节数组
}

第二步：修正NodeJS解密代码 #

const crypto = require('crypto');

// 定义GCM标准常量，与Golang默认值保持一致
const GCM_NONCE_SIZE = 12;
const GCM_TAG_SIZE = 16;

async function decrypt(data, enc_key) {
    if (!enc_key) {
        console.log("Encryption key is undefined");
        return null;
    }

    try {
        let decryptedEncKey = await encryptedKey(enc_key);
        // 校验密钥格式：必须是32字节的Buffer
        if (!(decryptedEncKey instanceof Buffer) || decryptedEncKey.length !== 32) {
            throw new Error("Invalid encryption key: must be 32-byte Buffer");
        }

        // 确保输入数据为Buffer类型，避免编码错误
        if (!(data instanceof Buffer)) {
            data = Buffer.from(data, 'binary'); // 根据实际传输编码调整，比如base64
        }

        const length = data.length;
        // 正确截取Nonce、密文、Tag
        const iv = data.slice(0, GCM_NONCE_SIZE);
        const tag = data.slice(length - GCM_TAG_SIZE, length);
        const encryptedData = data.slice(GCM_NONCE_SIZE, length - GCM_TAG_SIZE);

        // 初始化解密器并设置认证标签（关键步骤）
        const decipher = crypto.createDecipheriv('aes-256-gcm', decryptedEncKey, iv);
        decipher.setAuthTag(tag);

        // 执行解密并返回Buffer类型的图片数据
        const decrypted = Buffer.concat([
            decipher.update(encryptedData),
            decipher.final()
        ]);

        return decrypted;
    } catch (error) {
        console.error(error);
        console.log("Error in image decryption");
        return null;
    }
}

第三步：额外验证点 #

1. 数据传输完整性：加密后的二进制数据从Golang传到NodeJS时，避免用UTF-8编码传输，建议用Base64或直接二进制传输，防止数据损坏。
2. 附加数据一致性：如果Golang加密时使用了gcm.Seal的第四个附加数据参数，NodeJS解密时必须调用decipher.setAAD(additionalData)传入相同数据，否则也会认证失败（你的代码中Golang端该参数为nil，无需处理）。

内容的提问来源于stack exchange，提问作者Manoj vardhan reddy