使用workmanager解析大JSON文件致UI卡顿，如何修复？

核心问题分析 #

虽然workmanager的任务运行在独立Isolate，但UI卡顿的原因大概率是磁盘IO过载或单Isolate内串行处理大任务导致系统资源调度紧张——磁盘是共享资源，20余个大文件的串行/无限制并行读取会拖慢整个系统的IO响应，间接影响UI线程；同时单Isolate内的同步JSON解析（jsonDecode）会长时间占用该Isolate的线程时间，若系统资源不足也可能波及UI。

优化方案 #

不需要额外创建独立Isolate，但需要优化Isolate内的任务执行逻辑：

1. 分批次并行处理文件，控制IO负载

避免串行逐个读取文件，也不要无限制并行（会导致磁盘IO竞争），而是分小批量并行处理，平衡IO压力：

import 'dart:math'; // 用于min函数

@pragma('vm:entry-point')
void callbackDispatcher() {
  Workmanager().executeTask((task, inputData) async {
    final externalDir = await getApplicationDocumentsDirectory();
    List<FileSystemEntity> files = await Directory(externalDir.path).list().toList();

    // 每次并行处理3个文件（可根据设备性能调整）
    const batchSize = 3;
    for (int i = 0; i < files.length; i += batchSize) {
      final endIndex = min(i + batchSize, files.length);
      final batch = files.sublist(i, endIndex);
      
      // 并行处理当前批次的文件
      await Future.wait(batch.map((file) async {
        final content = await file.readAsString();
        final jsonMap = jsonDecode(content);
        // 处理解析后的JSON数据
      }));
    }

    return true;
  });
}

2. 用compute分散JSON解析任务到多核

jsonDecode是同步且CPU密集的操作，在单个Isolate内串行解析大文件会占用大量线程时间。利用compute可以将单个文件的解析任务分发到新Isolate，充分利用多核CPU，减轻当前Isolate的压力：

// 必须是顶级函数或static函数（Isolate间传递的函数要求）
Map<String, dynamic> parseJson(String content) {
  return jsonDecode(content);
}

@pragma('vm:entry-point')
void callbackDispatcher() {
  Workmanager().executeTask((task, inputData) async {
    final externalDir = await getApplicationDocumentsDirectory();
    List<FileSystemEntity> files = await Directory(externalDir.path).list().toList();

    const batchSize = 3;
    for (int i = 0; i < files.length; i += batchSize) {
      final endIndex = min(i + batchSize, files.length);
      final batch = files.sublist(i, endIndex);
      
      await Future.wait(batch.map((file) async {
        final content = await file.readAsString();
        // 用compute在独立Isolate解析JSON
        final jsonMap = await compute(parseJson, content);
        // 处理解析后的JSON数据
      }));
    }

    return true;
  });
}

3. 排查主Isolate交互风险

确保executeTask内没有任何与主Isolate的同步交互或大量数据传递：

• 不要调用WidgetsBinding.instance等主Isolate专属API
• 避免向主Isolate发送大体积对象（会触发耗时的序列化操作，占用主Isolate资源）

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