Flutter Web使用pointycastle库遇Uint64List不支持错误求解决

问题根源 #

Flutter Web的Dart开发编译器（DDC）不支持直接实例化Uint64List，而pointycastle库的GCM模式加密内部逻辑中使用了该类型，触发运行时不支持操作的错误。

解决方案 #

方案1：替换为Web兼容的加密库 #

使用encrypt库替代pointycastle，该库封装了pointycastle并处理了Web环境的兼容性问题，无需手动处理底层类型差异。

添加依赖到pubspec.yaml：

dependencies:
  encrypt: ^5.0.1

示例GCM加密代码：

import 'package:encrypt/encrypt.dart';

void encryptData() {
  final key = Key.fromUtf8('my 32 length key................');
  final iv = IV.fromLength(12);
  final encrypter = Encrypter(AES(key, mode: AESMode.gcm));

  final encrypted = encrypter.encrypt('hello world', iv: iv);
  final decrypted = encrypter.decrypt(encrypted, iv: iv);
}

方案2：修改pointycastle的GCM内部实现 #

如果必须使用原生pointycastle库，可修改gcm.dart中的_computeInitialCounter方法，替换Uint64List的使用为手动构造Uint8List：

1. 找到pointycastle包内的lib/block/modes/gcm.dart文件
2. 定位_computeInitialCounter方法，将原有代码：

var length = Uint8List.view((Uint64List(2)..[0] = iv.length * 8).buffer);

替换为：

Uint8List int64ToBytesBigEndian(int value) {
  var bytes = Uint8List(8);
  for (var i = 7; i >= 0; i--) {
    bytes[i] = value & 0xFF;
    value >>= 8;
  }
  return bytes;
}

var length = int64ToBytesBigEndian(iv.length * 8);

为避免直接修改库源码，可使用patch包动态修改该方法，或fork pointycastle仓库并应用修改后依赖自己的分支。

方案3：替换自定义代码中的Uint64List使用 #

如果是你自己的代码片段中用到了Uint64List，可以用手动构造Uint8List的方式实现相同的64位数值转字节功能：

替换原有代码：

var length = Uint8List.view((Uint64List(2)..[0] = iv.length * 8).buffer);

为：

Uint8List int64ToBytesBigEndian(int value) {
  var bytes = Uint8List(8);
  for (var i = 7; i >= 0; i--) {
    bytes[i] = value & 0xFF;
    value >>= 8;
  }
  return bytes;
}

var length = int64ToBytesBigEndian(iv.length * 8);

说明 #

优先推荐方案1，encrypt库已处理Web环境的各类兼容性问题，使用更省心。若必须使用pointycastle，方案2或3可解决Uint64List不支持的问题。

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