Flutter 实现 AES 解密，对标 Java 代码

聖光之護 2025-08-03 22:22 630浏览原创

flutter 实现 aes 解密，对标 java 代码

本文旨在帮助开发者在 Flutter 中实现与 Java Spring Boot 代码等效的 AES 解密功能。通过详细的代码示例和步骤说明，阐述了如何使用 encrypt 库进行 AES/CBC/PKCS5Padding 解密，并着重强调了密钥和初始化向量 (IV) 的正确处理方式，避免常见的错误配置，确保解密结果的准确性和安全性。

在 Flutter 中实现 AES 解密，特别是需要与现有的 Java 代码保持一致时，需要特别注意密钥 (Key) 和初始化向量 (IV) 的处理。以下是如何使用 encrypt 库在 Flutter 中实现与 Java Spring Boot 代码等效的 AES/CBC/PKCS5Padding 解密的详细步骤。

1. 引入 encrypt 库

首先，确保你的 pubspec.yaml 文件中包含了 encrypt 库：

dependencies:
  encrypt: ^5.0.1 # 使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 理解 Java 代码

提供的 Java 代码片段的关键点在于：

密钥 secretKey 和密文 str 都是 Base64 编码的。
使用了 AES/CBC/PKCS5Padding 加密算法。
IV 是 secretKey 的 Base64 编码后的前 16 个字节。

3. Flutter 实现

以下是 Flutter 中对应的解密代码：

import 'dart:convert';
import 'dart:typed_data';
import 'package:encrypt/encrypt.dart' as en;

String decryptAES256(String encryptedData, String secretKey) {
  // 密钥和密文都是 Base64 编码的
  final key = en.Key.fromBase64(secretKey);

  // IV 是密钥的 Base64 编码后的前 16 个字节
  final iv = en.IV(Uint8List.fromList(utf8.encode(secretKey).sublist(0, 16)));

  final encrypter = en.Encrypter(en.AES(key, mode: en.AESMode.cbc, padding: 'PKCS7')); // 注意padding方式

  final decrypted = encrypter.decrypt64(encryptedData, iv: iv);

  return decrypted;
}

void main() {
  const decryptKey = "MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MDE=";
  const encData = "lo0dOoJrHNRuefPXgkEa6jtDUhV5CguF9MHWTJ4Y8eGP8zHaKJEQIuOTZxstyk3X";

  final decryptedText = decryptAES256(encData, decryptKey);
  print('Decrypted Text: $decryptedText'); // 输出: The quick brown fox jumps over the lazy dog
}

代码解释：

en.Key.fromBase64(secretKey): 从 Base64 编码的字符串创建密钥。
en.IV(Uint8List.fromList(utf8.encode(secretKey).sublist(0, 16))): 创建 IV，取密钥的 Base64 编码字符串的前 16 个字节。需要注意的是，这里先将密钥字符串编码为 UTF-8 字节，然后再截取。
en.Encrypter(en.AES(key, mode: en.AESMode.cbc)): 创建 AES 加密器，指定 CBC 模式。
encrypter.decrypt64(encryptedData, iv: iv): 使用加密器解密 Base64 编码的密文。

4. 注意事项

密钥长度： encrypt 库要求密钥长度必须是 128/192/256 位（即 16/24/32 字节）。确保你的密钥长度符合要求。如果密钥长度不正确，会导致 "Key length not 128/192/256 bits" 错误。 Java 代码中使用Base64解码后的密钥长度必须符合要求。
编码方式： 确保 Java 和 Flutter 使用相同的字符编码方式，通常是 UTF-8。
IV 的安全性： 从密钥派生 IV 通常是不安全的，因为相同的密钥总是产生相同的 IV。更好的做法是为每次加密生成一个随机的 IV，并将 IV 与密文一起存储（例如，将 IV 放在密文的前面）。
PKCS7 Padding： 在 encrypt 库中，PKCS5Padding 通常被称为 PKCS7Padding，因为它们在 AES 中是等效的。在上面的代码中，添加了padding: 'PKCS7'来显式指定填充方式。

5. 安全性建议

虽然上述代码可以实现与 Java 代码等效的解密，但从安全角度来看，从密钥派生 IV 是不推荐的。更安全的做法是：

生成随机 IV： 为每次加密生成一个随机的 IV。
存储 IV： 将 IV 与密文一起存储，以便解密时使用。一种常见的做法是将 IV 放在密文的前面。

以下是使用随机 IV 的示例代码：

import 'dart:convert';
import 'dart:math';
import 'dart:typed_data';
import 'package:encrypt/encrypt.dart' as en;

String encryptAES256(String plaintext, String secretKey) {
  final key = en.Key.fromBase64(secretKey);
  final iv = en.IV.fromSecureRandom(16); // 生成 16 字节的随机 IV

  final encrypter = en.Encrypter(en.AES(key, mode: en.AESMode.cbc, padding: 'PKCS7'));
  final encrypted = encrypter.encrypt(plaintext, iv: iv);

  // 将 IV 和密文拼接在一起，方便解密
  return base64Encode(iv.bytes + encrypted.bytes);
}

String decryptAES256WithRandomIV(String encryptedData, String secretKey) {
  final key = en.Key.fromBase64(secretKey);
  final decodedData = base64Decode(encryptedData);

  // 从拼接后的数据中提取 IV 和密文
  final ivBytes = decodedData.sublist(0, 16);
  final encryptedBytes = decodedData.sublist(16);

  final iv = en.IV(Uint8List.fromList(ivBytes));
  final encrypter = en.Encrypter(en.AES(key, mode: en.AESMode.cbc, padding: 'PKCS7'));
  final decrypted = encrypter.decrypt(en.Encrypted(Uint8List.fromList(encryptedBytes)), iv: iv);

  return decrypted;
}

void main() {
  const decryptKey = "MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MDE=";
  const plaintext = "The quick brown fox jumps over the lazy dog";

  final encryptedData = encryptAES256(plaintext, decryptKey);
  print('Encrypted Data: $encryptedData');

  final decryptedText = decryptAES256WithRandomIV(encryptedData, decryptKey);
  print('Decrypted Text: $decryptedText');
}

总结

在 Flutter 中实现 AES 解密，需要仔细处理密钥、IV 和填充模式。为了安全起见，建议使用随机 IV，并将其与密文一起存储。通过遵循这些步骤和注意事项，你可以确保在 Flutter 中实现安全且正确的 AES 解密。