Flutter中如何等待SQLite数据加载完成以避免初始化错误？

你遇到的LateInitializationError是因为用late声明的child变量，在组件首次build时异步数据还未返回，此时直接访问未初始化的child导致错误。以下是两种可靠的解决方案：

方案1：使用FutureBuilder（推荐） #

这是Flutter处理异步数据加载的标准方式，无需手动管理setState和加载状态，直接绑定异步任务的生命周期：

修改状态类代码 #

late MonneyServices monneyServices;
late Future<Child> childFuture; // 用Future存储异步任务

@override
void initState() {
  super.initState();
  monneyServices = MonneyServices();
  childFuture = monneyServices.getChild(); // 初始化异步任务（只执行一次）
}

在build中用FutureBuilder构建UI #

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: FutureBuilder<Child>(
      future: childFuture,
      builder: (context, snapshot) {
        switch (snapshot.connectionState) {
          case ConnectionState.waiting:
            // 加载中：显示加载指示器
            return const Center(child: CircularProgressIndicator());
          case ConnectionState.done:
            if (snapshot.hasError) {
              // 加载失败：显示错误信息
              return Center(child: Text('加载失败：${snapshot.error}'));
            } else if (snapshot.hasData) {
              // 数据就绪：用返回的Child构建UI
              final child = snapshot.data!;
              return Column(
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  Text('姓名：${child.name}'),
                  Text('金额：${child.amount}'),
                ],
              );
            } else {
              // 无数据场景
              return const Center(child: Text('暂无数据'));
            }
          default:
            return const SizedBox();
        }
      },
    ),
  );
}

方案2：使用可空变量+加载状态 #

通过手动管理加载状态和可空变量，避免late带来的未初始化风险：

修改状态类代码 #

MonneyServices? monneyServices;
Child? child;
bool isLoading = true;

@override
void initState() {
  super.initState();
  monneyServices = MonneyServices();
  _loadChildData();
}

// 封装异步数据加载逻辑
void _loadChildData() async {
  try {
    final loadedChild = await monneyServices!.getChild();
    setState(() {
      child = loadedChild;
      isLoading = false;
    });
  } catch (e) {
    setState(() {
      isLoading = false;
      // 这里可添加错误处理，比如弹窗提示
    });
  }
}

在build中判断状态构建UI #

@override
Widget build(BuildContext context) {
  if (isLoading) {
    return const Center(child: CircularProgressIndicator());
  }
  
  if (child == null) {
    return const Center(child: Text('加载失败或无数据'));
  }
  
  // 数据就绪，构建业务UI
  return Center(
    child: Text('姓名：${child!.name} | 金额：${child!.amount}'),
  );
}

额外注意事项 #

1. 你的getChild()方法中，insertChild如果是异步方法，记得添加await，否则可能出现插入未完成就查询数据的问题：

await this.childDAO.insertChild(Child(1, "Alice", 10)); // 确保插入完成后再查询
List<Child> childList = await this.childDAO.getChilds();

2. 不要在build方法内直接调用异步方法，会导致每次组件重绘都重复执行异步任务，浪费资源。

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