Flutter如何在页面加载前异步初始化SQLite待办数据

initState是Flutter State生命周期中的同步执行方法，重写时必须严格遵守返回void的签名要求，绝对不能添加async关键字。添加async后方法返回值会变为Future<void>，不符合框架的重写规则，框架不会等待该异步方法执行完毕就会直接进入build流程，完全达不到页面加载前预取数据的效果。你最初直接在同步的initState中写await调用异步查询方法，IDE提示语法错误就是这个原因。

下面三种都是生产环境常用的初始化方案，适配你当前使用的sqflite: ^2.0.0+3版本，按需选择即可。

方案1：initState中调用封装的异步方法（适配现有代码结构，无额外依赖） #

这个写法改动最小，不需要引入新的依赖，逻辑简单直观：

class _HomePageState extends State<HomePage> {
  GlobalKey _inputViewKey = GlobalKey();
  List<Todo> _todos = [];

  @override
  void initState() {
    super.initState(); // 必须在initState最开头调用父类方法
    _loadTodoData(); // 调用单独封装的异步加载逻辑
  }

  // 封装异步查库逻辑
  Future<void> _loadTodoData() async {
    final res = await DBProvider.db.getAllTodo();
    // 数据返回前如果组件已经销毁，直接终止流程避免setState报错
    if (!mounted) return;
    setState(() {
      _todos = res;
    });
  }

  // 后续build逻辑正常写即可
}

关键注意点：异步数据返回后必须先判断mounted属性为true再调用setState，否则用户在数据加载过程中退出页面，会触发内存泄漏和控制台报错。
如果需要完全避免加载过程中的空白页面，可以搭配加载占位组件，也就是方案2的写法。

方案2：FutureBuilder实现初始化（自带加载/错误态，无需手动管理setState） #

这种写法不需要手动维护状态刷新逻辑，可以很方便的配置加载中、加载失败的占位视图，对用户体验更友好：

class _HomePageState extends State<HomePage> {
  GlobalKey _inputViewKey = GlobalKey();
  // 提前存储异步加载任务，避免build时重复触发
  late Future<List<Todo>> _loadTodoFuture;

  @override
  void initState() {
    super.initState();
    _loadTodoFuture = DBProvider.db.getAllTodo();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('待办清单')),
      body: FutureBuilder<List<Todo>>(
        future: _loadTodoFuture,
        builder: (context, snapshot) {
          // 加载中显示进度条
          if (snapshot.connectionState != ConnectionState.done) {
            return const Center(child: CircularProgressIndicator());
          }
          // 加载出错显示错误提示
          if (snapshot.hasError) {
            return Center(child: Text('待办加载失败：${snapshot.error}'));
          }
          // 加载完成渲染待办列表
          final todoList = snapshot.data ?? [];
          return ListView.builder(
            itemCount: todoList.length,
            itemBuilder: (context, index) => ListTile(
              title: Text(todoList[index].title), // 按你的Todo实体字段调整
            ),
          );
        },
      ),
    );
  }
}

避坑提醒：不要把数据库查询方法直接写在FutureBuilder的future参数里，否则每次build触发（比如键盘弹出、屏幕旋转、父组件重绘）都会重新执行查库操作，造成不必要的性能浪费。一定要在initState里提前把Future实例存到成员变量，再传给FutureBuilder。

方案3：addPostFrameCallback执行初始化（适合需要依赖BuildContext的场景） #

如果你的初始化逻辑除了查库，还需要用到BuildContext做操作（比如读取主题配置、显示初始化提示、获取MediaQuery尺寸），可以用帧回调的方式执行异步任务：

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) async {
    final res = await DBProvider.db.getAllTodo();
    if (!mounted) return;
    setState(() {
      _todos = res;
    });
  });
}

• 不要给initState加async：违反方法重写签名，框架不会等待异步执行，属于无效写法。
• 不要在build方法里直接执行异步查库：build会被高频触发，会导致重复查询、性能损耗。
• 异步回调中调用setState前必须判断mounted：避免组件销毁后触发状态更新报错。

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