如何解决Flutter State中使用Floor数据库时变量未初始化的报错？

问题原因 #

你声明了late AppDatabase database，但数据库初始化的build()方法是异步操作，then回调里的赋值动作会晚于initState执行完成。如果你在build方法里直接访问database，这时候变量还没完成赋值，就会抛出未初始化的报错。

解决方案 #

以下是两种常用的修复方案：

方案1：使用FutureBuilder处理异步初始化（推荐） #

直接在组件层处理异步加载逻辑，无需额外维护状态变量，也能避免重复初始化数据库：

class _DoctorScreenPageState extends State<DoctorScreenPage> {
  late Future<AppDatabase> databaseFuture;
  List<Doctor> doctors = [];
  late StreamSubscription subscription;

  @override
  void initState() {
    super.initState();
    // 仅在initState中初始化一次Future
    databaseFuture = $FloorAppDatabase
        .databaseBuilder('database.db')
        .build();
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<AppDatabase>(
      future: databaseFuture,
      builder: (context, snapshot) {
        // 数据库初始化中显示加载指示器
        if (snapshot.connectionState != ConnectionState.done) {
          return const Center(child: CircularProgressIndicator());
        }
        // 初始化完成后获取数据库实例
        final database = snapshot.data!;
        // 此处正常编写你的页面业务逻辑
        return Scaffold(
          // 你的页面代码
        );
      },
    );
  }
}

方案2：新增加载状态变量控制渲染 #

如果你需要将database作为State全局变量使用，可以新增加载状态标记，初始化完成后触发重绘：

class _DoctorScreenPageState extends State<DoctorScreenPage> {
  late AppDatabase database;
  List<Doctor> doctors = [];
  late StreamSubscription subscription;
  // 新增数据库初始化状态标记
  bool _isDbInitialized = false;

  @override
  void initState() {
    super.initState();
    $FloorAppDatabase
        .databaseBuilder('database.db')
        .build()
        .then((value) async {
      database = value;
      // 赋值完成后更新状态触发重绘
      setState(() {
        _isDbInitialized = true;
      });
      // 此处可执行初始化后逻辑，比如监听医生数据流
    });
  }

  @override
  Widget build(BuildContext context) {
    // 未初始化完成时显示加载页
    if (!_isDbInitialized) {
      return const Center(child: CircularProgressIndicator());
    }
    // 初始化完成后正常渲染页面
    return Scaffold(
      // 你的页面代码
    );
  }
}

注意事项 #

不要在build方法中直接调用$FloorAppDatabase.databaseBuilder().build()，否则每次组件重绘都会重复创建数据库实例，造成不必要的性能损耗。

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