Java中使用AES-GCM进行带认证标签的解密完整教程-java教程-PHP中文网

Java中使用AES-GCM进行带认证标签的解密完整教程

本文详解如何在java 8中正确实现aes/gcm解密，重点处理node.js兼容的base64编码iv、认证标签（authentication tag）和密钥，并确保gcm模式下完整性校验通过。

本文详解如何在java 8中正确实现aes/gcm解密，重点处理node.js兼容的base64编码iv、认证标签（authentication tag）和密钥，并确保gcm模式下完整性校验通过。

AES/GCM（Galois/Counter Mode）是一种同时提供机密性与完整性保护的认证加密模式，其核心在于解密时必须严格验证认证标签（Authentication Tag）。与Node.js中decipher.setAuthTag()直接传入标签不同，Java的Cipher类不通过独立方法设置tag，而是将IV与tag共同构成GCM参数，并在doFinal()调用前隐式完成校验——若标签不匹配，doFinal()将抛出AEADBadTagException（而非静默失败），这是安全设计的关键。

以下为完整、可运行的Java 8兼容实现：

Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。

下载

import javax.crypto.Cipher;
import javax.crypto.SecretKey;
import javax.crypto.spec.GCMParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import java.nio.charset.StandardCharsets;
import java.util.Base64;

public class AESGCMDecryptor {

    private static final String TRANSFORMATION = "AES/GCM/NoPadding";
    private static final int TAG_LENGTH_BITS = 128; // 必须与加密端一致（Node.js crypto默认128位）

    public static String decrypt(String ciphertextB64, String ivB64, String tagB64, String key) throws Exception {
        // Base64解码输入
        byte[] iv = Base64.getDecoder().decode(ivB64);
        byte[] tag = Base64.getDecoder().decode(tagB64);
        byte[] cipherBytes = Base64.getDecoder().decode(ciphertextB64);
        byte[] keyBytes = key.getBytes(StandardCharsets.UTF_8);

        // 构建密钥与GCM参数
        SecretKey secretKey = new SecretKeySpec(keyBytes, "AES");
        GCMParameterSpec gcmSpec = new GCMParameterSpec(TAG_LENGTH_BITS, iv);

        // 初始化解密器
        Cipher cipher = Cipher.getInstance(TRANSFORMATION);
        cipher.init(Cipher.DECRYPT_MODE, secretKey, gcmSpec);

        // ⚠️ 关键注意：Java中无需显式调用updateAAD()传入tag！
        // GCMParameterSpec已包含IV，而tag是cipher.doFinal()内部自动校验的组成部分。
        // 错误地调用cipher.updateAAD(tag)会导致javax.crypto.AEADBadTagException或解密失败。

        // 执行解密（自动校验tag）
        byte[] plaintextBytes = cipher.doFinal(cipherBytes);
        return new String(plaintextBytes, StandardCharsets.UTF_8);
    }

    public static void main(String[] args) throws Exception {
        String ciphertext = "2LPVwa7s4+xyd8KF94r07TOCaOdf4X90NWqhHQCpoJGT+T3TYjKCWf3V+A==";
        String iv = "S4/yimaF8bu0jQW9uagIJA==";
        String tag = "L6BtTic18dd4fNL2maytFA==";
        String key = "password1232asdfpassword1232asdf";

        String result = decrypt(ciphertext, iv, tag, key);
        System.out.println("Decrypted: \"" + result + "\"");
        // 输出：Decrypted: "The quick brown fox jumps over the lazy dog"
    }
}

关键注意事项与最佳实践：

✅ Tag不可手动注入AAD：cipher.updateAAD(tag) 是常见误区。GCM模式中，认证标签是密文的一部分（通常追加在密文末尾），Java Cipher 在 doFinal() 中自动提取并校验。Node.js 的 setAuthTag() 是显式分离接口，而Java通过GCMParameterSpec（仅含IV）+ doFinal()（隐式校验）实现等效逻辑。
✅ 密钥编码一致性：Node.js示例中key为原始字符串（非Hex/Base64），Java中应使用key.getBytes(UTF_8)保持字节级一致。若Node端使用Buffer.from(key, 'hex')，则Java需先Hex解码。
✅ IV长度要求：GCM推荐IV长度为12字节（96位）。本例中Base64解码后iv.length == 12，符合规范；若长度不符，GCMParameterSpec构造会抛出异常。
✅ 异常处理：务必捕获javax.crypto.AEADBadTagException（标签校验失败）和InvalidKeyException/InvalidAlgorithmParameterException，用于区分密钥错误、参数错误或篡改攻击。
? JCE策略文件：Java 8默认限制AES密钥长度≤128位。若使用256位密钥（如本例32字节），需安装JCE Unlimited Strength Policy Files（Java 9+已默认启用）。