Flutter Web使用sqflite遇databaseFactory未初始化错误，求解决办法

你遇到的Bad state: databaseFactory not initialized错误，本质是sqflite官方不支持Flutter Web端，下面提供两种可行的解决办法，步骤都简化到最低复杂度：

方案1：用sqflite_common_ffi_web快速适配（最小改动原有代码） #

这个方案可以直接复用你现有sqflite的操作逻辑，只需要加几行配置：

• 第一步：在pubspec.yaml里添加依赖

  dependencies:
    sqflite_common_ffi_web: ^0.4.0
  

• 第二步：在应用启动时初始化Web端数据库工厂，比如main函数里：

  import 'package:sqflite_common_ffi_web/sqflite_ffi_web.dart';
  import 'package:sqflite/sqflite.dart';
  
  void main() {
    // 初始化Web端专属的数据库工厂
    databaseFactory = databaseFactoryFfiWeb;
    // 正常启动应用
    runApp(const MyApp());
  }
  

• 第三步：原有数据库操作代码完全不用改，比如原来的openDatabase调用直接保留：

  final db = await openDatabase('my_database.db');
  

  注：Web端底层用IndexedDB存储，路径逻辑已经被封装，不用额外调整。

方案2：迁移到Drift（推荐长期维护场景） #

如果你的项目计划长期跨平台迭代，Drift是更稳定的选择，它原生支持Web，迁移成本也可控：

• 第一步：添加依赖到pubspec.yaml

  dependencies:
    drift: ^2.12.0
    drift_web: ^2.12.0
    sqlite3_flutter_libs: ^0.5.16 # 自动适配移动端，Web端无需额外处理
  dev_dependencies:
    drift_dev: ^2.12.0
    build_runner: ^2.4.4
  

• 第二步：定义数据库和表（示例）

  import 'package:drift/drift.dart';
  import 'package:drift_web/drift_web.dart';
  
  // 定义数据表结构
  class Todos extends Table {
    IntColumn get id => integer().autoIncrement()();
    TextColumn get title => text()();
    BoolColumn get completed => boolean().withDefault(const Constant(false))();
  }
  
  // 数据库核心类
  class AppDatabase extends _$AppDatabase {
    AppDatabase() : super(_openConnection());
  
    @override
    int get schemaVersion => 1;
  
    // 示例查询方法，和sqflite逻辑对应
    Future<List<Todo>> get allTodos => select(todos).get();
  }
  
  // 初始化Web端数据库连接
  LazyDatabase _openConnection() {
    return LazyDatabase(() async {
      return WebDatabase('app_db');
    });
  }
  

• 第三步：生成数据库代码，执行命令：

  flutter pub run build_runner build
  

• 第四步：在应用中调用数据库

  final db = AppDatabase();
  // 原有sqflite的SQL语句可以用customSelect直接执行，比如：
  // final result = await db.customSelect('SELECT * FROM todos').get();
  final todos = await db.allTodos;
  

提示：如果现有代码量很大，优先选方案1快速搞定；如果是新项目或打算重构数据库逻辑，方案2更适合长期维护。

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