如何在Flutter原生插件中同步调用Dart代码以保留文件访问权限？

Flutter的MethodChannel通信是异步设计的，无法在NSFileCoordinator的回调中阻塞线程等待Dart执行文件读取——不仅会导致线程阻塞问题，更关键的是Dart层面无法获取NSFileCoordinator的权限上下文，直接访问URL会失败。正确的思路是在原生回调的权限有效期内完成文件读取，再将结果异步传递给Dart，以下是两种可行方案：

方案一：小文件一次性读取后返回 #

适合体积较小的文件，直接在NSFileCoordinator的回调中读取文件内容，通过FlutterResult返回给Dart：

public func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
    guard let args = call.arguments as? [String: Any],
          let filePath = args["file_path"] as? String,
          let url = URL(fileURLWithPath: filePath) else {
        result(FlutterError(code: "INVALID_ARG", message: "无效的文件路径", details: nil))
        return
    }
    
    var coordinatorError: NSError?
    NSFileCoordinator().coordinate(readingItemAt: url, error: &coordinatorError) { accessUrl in
        do {
            // 根据文件类型选择读取方式：文本用String(contentsOf:)，二进制用Data(contentsOf:)
            let fileData = try Data(contentsOf: accessUrl)
            // 将二进制数据转为Base64字符串返回（Dart端可解码回Uint8List）
            result(fileData.base64EncodedString())
        } catch let readError {
            result(FlutterError(code: "READ_FAILED", message: readError.localizedDescription, details: nil))
        }
    }
    
    if let error = coordinatorError {
        result(FlutterError(code: "COORDINATE_FAILED", message: error.localizedDescription, details: nil))
    }
}

Dart端接收后解码：

void readFile(String filePath) async {
  const channel = MethodChannel('com.example.file_plugin');
  try {
    String base64Str = await channel.invokeMethod('read_file', {'file_path': filePath});
    Uint8List fileData = base64Decode(base64Str);
    // 处理文件数据
  } on PlatformException catch (e) {
    print("读取失败：${e.message}");
  }
}

方案二：大文件流式传输 #

如果文件体积较大，一次性读取会占用过多内存，可通过FlutterEventChannel实现流式传输，在权限上下文内分块读取并逐块发送给Dart：

原生Swift端实现流处理器 #

class FileStreamHandler: NSObject, FlutterStreamHandler {
    private var eventSink: FlutterEventSink?
    private var targetUrl: URL?

    func onListen(withArguments arguments: Any?, eventSink: @escaping FlutterEventSink) -> FlutterError? {
        self.eventSink = eventSink
        guard let filePath = arguments as? String else {
            return FlutterError(code: "INVALID_ARG", message: "缺少文件路径参数", details: nil)
        }
        let url = URL(fileURLWithPath: filePath)
        
        var coordinatorError: NSError?
        NSFileCoordinator().coordinate(readingItemAt: url, error: &coordinatorError) { [weak self] accessUrl in
            self?.targetUrl = accessUrl
            self?.startStreaming()
        }
        
        if let error = coordinatorError {
            return FlutterError(code: "COORDINATE_FAILED", message: error.localizedDescription, details: nil)
        }
        return nil
    }

    func onCancel(withArguments arguments: Any?) -> FlutterError? {
        eventSink = nil
        targetUrl = nil
        return nil
    }

    private func startStreaming() {
        guard let url = targetUrl, let sink = eventSink else { return }
        let chunkSize = 1024 * 1024 // 1MB 分块大小
        
        do {
            let fileHandle = try FileHandle(forReadingFrom: url)
            defer { fileHandle.closeFile() }
            
            while let chunk = fileHandle.readData(ofLength: chunkSize), !chunk.isEmpty {
                sink(chunk) // 直接发送二进制块
            }
            sink(FlutterEndOfEventStream) // 标记流结束
        } catch let error {
            sink(FlutterError(code: "STREAM_ERROR", message: error.localizedDescription, details: nil))
        }
    }
}

// 在插件注册时绑定流通道
public static func register(with registrar: FlutterPluginRegistrar) {
    let streamChannel = FlutterEventChannel(name: "com.example.file_stream", binaryMessenger: registrar.messenger())
    streamChannel.setStreamHandler(FileStreamHandler())
}

Dart端监听流 #

final _fileStreamChannel = EventChannel('com.example.file_stream');

void startFileStream(String filePath) {
  _fileStreamChannel.receiveBroadcastStream(filePath).listen(
    (data) {
      if (data is Uint8List) {
        // 处理单个文件块
        print("收到文件块，大小：${data.length}字节");
      }
    },
    onError: (PlatformException error) {
      print("流错误：${error.message}");
    },
    onDone: () {
      print("文件流传输完成");
    },
  );
}

关键说明 #

• 不要尝试在NSFileCoordinator回调中阻塞线程等待Dart调用：Flutter的跨端通信是异步的，阻塞线程会导致UI卡顿或线程死锁，且Dart无法继承原生的权限上下文，直接访问URL必然失败。
• 所有文件操作必须在NSFileCoordinator的回调闭包内完成：闭包执行完毕后，系统会回收文件访问权限，任何后续对该URL的操作都会被拒绝。

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