Flutter读写JSON文件触发FormatException与LateInitializationError报错问询

云上老周

2026-10-4

问题原因

FormatException: Unexpected end of input 报错根因：文件读写异步操作时序错误，写入JSON的操作未完成就提前执行读取逻辑，导致读取到空字符串或不完整的JSON内容，jsonDecode解析空内容时就会触发第一行输入意外结束的异常。少数情况是写入的内容本身不是合法JSON结构，或读写时编码不一致导致内容乱码。
LateInitializationError: Field 'fileContent' has not been initialized 报错根因：你用late修饰了fileContent变量，但Flutter的组件构建是同步执行的，你初始化fileContent的异步读文件操作未执行完成时，Home组件就已经开始构建并访问该变量，late变量在被访问前未赋值就会抛出该异常，仅给方法加async修饰不会阻塞组件构建流程，因此无法解决问题。

解决方案

修复文件读写时序
所有文件读写操作都必须加await等待执行完成，确保写入完成后再执行读取，示例参考：

// 错误写法，写操作未完成就执行读
writeJsonFile(jsonContent);
final readResult = await readJsonFile();

// 正确写法
await writeJsonFile(jsonContent);
final readResult = await readJsonFile();

写入内容前可以先通过jsonEncode校验格式合法性，避免写入非法JSON或空内容。

处理异步变量初始化时序
不要直接在构建流程中访问未完成初始化的late变量，推荐两种修改方案：

方案1：用FutureBuilder包裹依赖fileContent的组件，等待异步操作完成后再渲染界面，示例参考：

class _MyHomePageState extends State<MyHomePage> {
  late String fileContent;
  late Future<String> _loadFileFuture;

  @override
  void initState() {
    super.initState();
    _loadFileFuture = _loadFileContent();
  }

  Future<String> _loadFileContent() async {
    // 你的读文件逻辑
    final file = await getLocalFile();
    fileContent = await file.readAsString(encoding: utf8);
    return fileContent;
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder(
      future: _loadFileFuture,
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.done) {
          // 此时fileContent已完成赋值，可安全使用
          return HomeComponent(content: fileContent);
        }
        // 异步加载中显示占位组件
        return const Center(child: CircularProgressIndicator());
      },
    );
  }
}

方案2：将late String fileContent改为可空类型String? fileContent，构建时先判断变量是否为空，为空时显示加载占位，非空再渲染正常组件，从根源避免late变量未初始化的风险。

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