Flutter导入大体积Excel文件解码失败及性能问题求助

问题背景 #

导入小体积（小于2k）Excel文件正常，但大文件导入时在var bytes = await File(file).readAsBytes();处耗时过长，同时抛出FormatException: Could not find End of Central Directory Record异常，涉及文件路径：/data/user/0/com.example.flutter_file_reader/cache/file_picker/myAssetList.xlsx。

核心原因 #

1. 内存过载：readAsBytes()一次性将整个大文件的字节加载到内存，不仅耗时久，还容易触发内存溢出，导致文件字节被截断，Excel解析库无法找到关键的文件结构标记（End of Central Directory Record）。
2. 库兼容性：当前使用的Excel解析库对大文件的内存处理和结构解析支持不足，小文件内存占用低所以能正常工作。
3. 文件完整性：文件选择器将大文件复制到缓存路径时可能出现截断，导致文件损坏。

解决方案 #

1. 优化文件读取方式 #

避免一次性加载全量字节，改用流读取的方式确保字节完整收集，同时降低内存峰值：

// 替换原readAsBytes()的代码
var bytes = await File(file).openRead().fold<Uint8List>(
  Uint8List(0),
  (previous, chunk) => Uint8List.fromList([...previous, ...chunk]),
);

2. 更换高效的Excel解析库 #

推荐使用spreadsheet_decoder或excelize这类对大文件更友好的库，它们在内存管理和解析效率上更出色。以下是spreadsheet_decoder的实现示例：

import 'package:spreadsheet_decoder/spreadsheet_decoder.dart';
import 'dart:io';
import 'dart:developer' as dev;

importFromExcel(String fileLocation) async {
  List<List<dynamic>> _listData = [];
  try {
    final bytes = await File(fileLocation).readAsBytes();
    final decoder = SpreadsheetDecoder.decodeBytes(bytes);
    
    for (var sheetName in decoder.tables.keys) {
      final sheet = decoder.tables[sheetName]!;
      for (var row in sheet.rows) {
        // 直接转换行数据，避免重复创建临时变量
        final rowDetail = row.map((cell) => cell?.value.toString() ?? '').toList();
        _listData.add(rowDetail);
      }
    }
    return _listData;
  } catch (e) {
    dev.log(e.toString());
    return [];
  }
}

3. 验证文件完整性 #

检查缓存路径下的Excel文件是否完整：

• 对比原文件和缓存文件的大小，确认无截断
• 尝试手动打开缓存文件，验证是否能正常打开

4. 优化内存使用 #

原代码中重复复用rowdetail列表存在潜在内存问题，改为循环内直接初始化列表：

// 优化原循环逻辑
for (var table in excel.tables.keys) {
  for (var row in excel.tables[table]!.rows) {
    List<String> rowDetail = [];
    for (var cell in row) {
      rowDetail.add(cell?.value.toString() ?? '');
    }
    _listData.add(rowDetail);
  }
}

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