Flutter中json.decode是否存在解析大小限制？

核心问题 #

解析20万条JSON数据转换为Dictionary列表时程序卡顿，但前8000条解析速度正常，JSON由SQLite数据库导出且格式合规，需排查原因并解决卡顿问题。

1. 并非解析大小限制，而是内存与同步阻塞导致卡顿 #

Dart的json.decode会一次性将整个20万条数据的JSON字符串加载到内存，后续同步遍历转换模型的操作会单线程阻塞事件循环，导致UI或程序响应卡顿。前8000条数据量小，内存占用和处理时间极低，因此无明显卡顿感。

可以通过以下代码验证耗时分布：

Stopwatch stopwatch = Stopwatch()..start();
String peuJson = await getPeuJson();
print('加载JSON耗时: ${stopwatch.elapsedMilliseconds}ms');
stopwatch.reset();
List<Dictionary> dicts = (json.decode(peuJson) as List)
    .map((i) => Dictionary.fromJson(i))
    .toList();
print('转换模型耗时: ${stopwatch.elapsedMilliseconds}ms');

2. 数据损坏的排查方式 #

如果是数据损坏，通常会直接抛出解析错误（如格式不完整、字段类型不匹配），而非单纯卡顿。可通过以下步骤验证：

• 分段测试：抽取中间段、末尾段各1万条数据单独解析，确认是否能正常完成，有无报错。
• 格式校验：用本地JSON校验工具（或Dart的json.decode单独测试可疑片段）检查整个文件的括号、逗号等格式是否完整，重点确认最后几条数据的格式合法性。
• 字段匹配检查：确认Dictionary.fromJson处理的所有字段在JSON中都存在，无类型不匹配情况（如JSON存字符串但模型要求数字），隐性类型转换可能导致性能损耗或错误。

3. 卡顿优化方案 #

（1）分批异步处理

将大列表拆分为小批次，异步处理每一批，避免一次性阻塞线程：

String peuJson = await getPeuJson();
List<dynamic> rawList = json.decode(peuJson) as List;
List<Dictionary> dicts = [];
final batchSize = 1000; // 每批处理1000条
for (int i = 0; i < rawList.length; i += batchSize) {
  final end = i + batchSize > rawList.length ? rawList.length : i + batchSize;
  final batch = rawList.sublist(i, end);
  // 异步执行批次转换，让出事件循环
  await Future(() {
    dicts.addAll(batch.map((item) => Dictionary.fromJson(item)).toList());
  });
}

（2）流式解析（推荐）

若JSON来自本地文件，不要一次性加载整个字符串，用流式解析降低内存占用：

import 'dart:convert';
import 'dart:io';

Future<List<Dictionary>> parseLargeJson(File file) async {
  List<Dictionary> dicts = [];
  final stream = file.openRead();
  await stream
      .transform(utf8.decoder)
      .transform(JsonDecoder())
      .listen((dynamic data) {
    if (data is List) {
      dicts.addAll(data.map((item) => Dictionary.fromJson(item)).toList());
    }
  }).asFuture();
  return dicts;
}

（3）优化Dictionary.fromJson方法

检查fromJson中是否包含耗时操作（如复杂计算、IO），尽量简化字段映射。推荐使用json_serializable等代码生成工具自动生成高效的序列化代码，避免手动解析带来的性能损耗。

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