如何在Flutter助手类中存储sqflite数据库实例？

我正在尝试在Flutter中使用sqflite，只想创建一个处理数据库连接的助手类（不在类内执行查询），编写了以下代码：

//SQL dependencies
import 'dart:async';

import 'package:flutter/widgets.dart';
import 'package:path/path.dart';
import 'package:sqflite/sqflite.dart';

class DatabaseHelper {
  static Database _db;

  connect() async {
    // Avoid errors caused by flutter upgrade.
    // Importing 'package:flutter/widgets.dart' is required.
    WidgetsFlutterBinding.ensureInitialized();
    
    // Open the database and store the reference.
    // Note:Using the `join` function from the `path` package is best practice to ensure the 
    // path is correctly constructed for each platform.
    var pathToDB = join(await getDatabasesPath(), 'notebook_database.db');

    _db = await openDatabase(
        pathToDB,
        version: 1
    );
  }

  Future<Database> get db async {
    if (_db != null) return _db;
    
    _db = await connect();
    return _db;
  }
}

但在static Database _db行遇到错误，提示“Non nullable variable must be initialized”，请问在类中存储数据库实例的正确方法是什么？

修复方案 #

这个错误来自Dart的空安全机制：Database是非可空类型，但静态变量_db没有初始值，违反了空安全规则。同时原代码里connect方法没有返回值，会导致_db = await connect()赋值失败，需要一起修正。

方案1：将变量声明为可空类型

把_db改为可空的Database?，同时调整getter里的非空断言：

//SQL dependencies
import 'dart:async';

import 'package:flutter/widgets.dart';
import 'package:path/path.dart';
import 'package:sqflite/sqflite.dart';

class DatabaseHelper {
  static Database? _db; // 声明为可空类型

  // 给connect方法添加返回类型，确保能返回数据库实例
  Future<Database> connect() async {
    WidgetsFlutterBinding.ensureInitialized();
    var pathToDB = join(await getDatabasesPath(), 'notebook_database.db');

    return await openDatabase(
      pathToDB,
      version: 1,
      // 可选：首次创建数据库时执行建表操作
      // onCreate: (db, version) {
      //   return db.execute('CREATE TABLE notes(id INTEGER PRIMARY KEY, title TEXT)');
      // },
    );
  }

  Future<Database> get db async {
    if (_db != null) return _db!; // 非空断言，因为已判断不为null
    
    _db = await connect();
    return _db!;
  }
}

方案2：使用late关键字

如果能保证_db在被访问前一定会被初始化，可以用late关键字声明，告诉Dart该变量稍后会被赋值：

static late Database _db;

这种方式不需要修改变量的可空性，但要注意：如果在_db未初始化时直接访问，会抛出LateInitializationError。结合你的db getter逻辑，每次访问都会先检查是否为null，再初始化，所以这个方案是安全的。同样需要修正connect方法的返回值问题。

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