需切换至AES/GCM/NoPadding并兼容AES/ECB旧加密数据求方案

为什么不能只靠try-catch #

仅通过try-catch切换解密逻辑的问题很明显：

• ECB解密失败可能是密钥错误、数据损坏等非格式问题，会误判为GCM数据
• GCM解密失败同理，容易导致逻辑混乱，无法准确定位问题

可靠兼容方案实现 #

1. 给新加密数据加标识头 #

新数据用GCM加密时，给结果加固定标识前缀（比如1字节0x01），同时GCM需要保存IV和Tag（解密必须依赖IV，Tag用于校验数据完整性）。最终新数据结构：
[标识字节(0x01)] + [IV(12字节)] + [密文] + [Tag(16字节)]

• IV选12字节是GCM标准推荐，兼顾安全性和性能
• Tag默认16字节，用于校验数据是否被篡改

2. 解密时先判断数据类型 #

先读取标识字节，再选择对应解密逻辑，比try-catch更可靠：

import javax.crypto.Cipher;
import javax.crypto.spec.GCMParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import java.nio.ByteBuffer;
import java.util.Arrays;

public class AESDecryptor {
    public byte[] decrypt(byte[] encryptedData, byte[] secretKeyBytes) throws Exception {
        if (encryptedData == null || encryptedData.length == 0) {
            throw new IllegalArgumentException("Encrypted data cannot be empty");
        }

        SecretKeySpec secretKey = new SecretKeySpec(secretKeyBytes, "AES");
        byte firstByte = encryptedData[0];

        // 处理新的GCM格式数据
        if (firstByte == 0x01) {
            // 拆分数据：标识(1) + IV(12) + 密文 + Tag(16)
            if (encryptedData.length < 1 + 12 + 16) {
                throw new IllegalArgumentException("Invalid GCM format data");
            }
            byte[] iv = Arrays.copyOfRange(encryptedData, 1, 13);
            byte[] cipherTextWithTag = Arrays.copyOfRange(encryptedData, 13, encryptedData.length);
            
            Cipher cipher = Cipher.getInstance("AES/GCM/NoPadding");
            GCMParameterSpec spec = new GCMParameterSpec(128, iv); // 128位Tag长度
            cipher.init(Cipher.DECRYPT_MODE, secretKey, spec);
            
            // GCM的doFinal会自动校验Tag，无需手动拆分
            return cipher.doFinal(cipherTextWithTag);
        } else {
            // 处理旧的ECB格式数据（无标识头）
            try {
                Cipher cipher = Cipher.getInstance("AES/ECB/PKCS5Padding");
                cipher.init(Cipher.DECRYPT_MODE, secretKey);
                byte[] decrypted = cipher.doFinal(encryptedData);
                
                // 可选：业务层验证，比如判断解密后是否是预期的JSON/字符串格式
                // 避免因数据损坏导致的误解密
                return decrypted;
            } catch (Exception e) {
                throw new IllegalArgumentException("Failed to decrypt old ECB format data", e);
            }
        }
    }

    // 新数据加密方法（GCM模式）
    public byte[] encrypt(byte[] plainData, byte[] secretKeyBytes) throws Exception {
        SecretKeySpec secretKey = new SecretKeySpec(secretKeyBytes, "AES");
        
        // 生成12字节随机IV
        byte[] iv = new byte[12];
        new java.security.SecureRandom().nextBytes(iv);
        
        Cipher cipher = Cipher.getInstance("AES/GCM/NoPadding");
        GCMParameterSpec spec = new GCMParameterSpec(128, iv);
        cipher.init(Cipher.ENCRYPT_MODE, secretKey, spec);
        
        // 加密后的数据包含密文+Tag
        byte[] cipherTextWithTag = cipher.doFinal(plainData);
        
        // 组装带标识的最终数据
        ByteBuffer buffer = ByteBuffer.allocate(1 + iv.length + cipherTextWithTag.length);
        buffer.put((byte) 0x01);
        buffer.put(iv);
        buffer.put(cipherTextWithTag);
        
        return buffer.array();
    }
}

3. 关键注意事项 #

• 停止使用ECB加密新数据：ECB是不安全的模式，所有新生成的加密数据必须用GCM
• 旧数据验证：解密旧ECB数据后，建议添加业务层校验（比如检查数据格式、签名），避免无效数据
• 密钥安全：不要硬编码AES密钥，使用Android Keystore存储密钥，防止泄露
• 异常区分：针对不同异常场景（密钥错误、数据损坏、格式不支持）给出明确错误信息，便于排查

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