Flutter encrypt包跨平台加解密兼容问题：如何实现通用加解密？

问题根源 #

你的代码存在以下隐性跨平台兼容风险：

• 依赖IV.fromLength(16)生成固定IV，虽理论上是全0字节，但不同平台加密库对固定IV的处理逻辑可能存在差异
• 未显式指定字符串编码与填充模式，导致跨平台字符解析、加密填充行为不一致
• 未统一密钥的生成逻辑，若密钥来源是字符串，不同平台的字符串转字节过程可能存在差异

修正后的跨平台通用代码 #

1. 统一密钥生成（确保跨平台密钥字节一致）

如果你的密钥来自字符串，通过哈希算法生成标准长度的AES密钥：

import 'dart:convert';
import 'package:crypto/crypto.dart';
import 'package:encrypt/encrypt.dart';

Key generateAESKey(String keyString) {
  // 用SHA-256生成32字节密钥（对应AES-256）
  final keyBytes = utf8.encode(keyString);
  final hashBytes = sha256.convert(keyBytes).bytes;
  return Key.fromBytes(hashBytes);
}

2. 加密函数（带随机IV并与密文绑定）

String encryptAES(String plainText, Key secretKey) {
  final iv = IV.random(16); // 生成16字节随机IV（CBC模式要求IV长度等于块大小）
  final encrypter = Encrypter(
    AES(secretKey, mode: AESMode.cbc, padding: 'PKCS7'),
  );
  final encrypted = encrypter.encrypt(plainText, iv: iv, encoding: Encoding.utf8);
  // 将IV和密文用非Base64字符拼接，方便解密时拆分
  return '${iv.base64}|${encrypted.base64}';
}

3. 解密函数（拆分IV与密文）

String decryptAES(String encryptedData, Key secretKey) {
  final parts = encryptedData.split('|');
  if (parts.length != 2) {
    throw ArgumentError('无效的加密数据格式');
  }
  final iv = IV.fromBase64(parts[0]);
  final encrypted = Encrypted.fromBase64(parts[1]);
  final encrypter = Encrypter(
    AES(secretKey, mode: AESMode.cbc, padding: 'PKCS7'),
  );
  return encrypter.decrypt(encrypted, iv: iv, encoding: Encoding.utf8);
}

关键兼容要点 #

• 显式指定填充模式：强制使用PKCS7填充，避免不同平台默认填充逻辑差异
• 统一字符编码：明确用UTF-8转换字符串与字节，消除跨平台字符解析不一致
• IV与密文绑定传输：随机IV是CBC模式安全的必要条件，同时避免固定IV带来的隐性兼容问题
• 标准化密钥生成：通过哈希算法生成固定长度的密钥，确保相同输入字符串在所有平台生成完全一致的密钥字节
• 统一依赖版本：所有平台使用相同版本的encrypt包，避免版本迭代导致的实现差异

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