Flutter桌面应用构建后sqflite_common_ffi无法正常工作

以下是针对Windows平台exe/msix打包后数据库交互失败的排查和解决方案：

1. 修正数据库文件路径处理 #

开发环境中相对路径（如./my_db.db）可能正常，但打包后应用工作目录会变化，导致找不到数据库文件。必须使用应用专属的可读写目录存储数据库：

import 'package:path_provider/path_provider.dart';
import 'package:sqflite_common_ffi/sqflite_ffi.dart';

Future<Database> initDatabase() async {
  // 获取应用专属文档目录（有读写权限）
  final appDocDir = await getApplicationDocumentsDirectory();
  final dbPath = '${appDocDir.path}/app_database.db';
  
  databaseFactory = databaseFactoryFfi;
  return openDatabase(
    dbPath,
    version: 1,
    onCreate: (db, version) {
      // 执行表创建SQL
      db.execute('CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT)');
    },
  );
}

避免使用当前工作目录的相对路径，优先用path_provider提供的系统标准目录。

2. 确保sqlite3.dll被正确打包 #

针对exe构建 #

将sqlite3.dll放在与最终生成的exe文件同一目录下，不要手动放在项目源码目录后直接构建，需手动复制到输出目录（如build/windows/x64/runner/Release）。

针对msix构建 #

通过pubspec.yaml配置assets自动包含dll，并在初始化时复制到可访问路径：

1. 在项目根目录创建assets文件夹，放入sqlite3.dll
2. 修改pubspec.yaml：

flutter:
  assets:
    - assets/sqlite3.dll

3. 初始化时复制并加载dll：

import 'package:flutter/services.dart';
import 'package:path/path.dart' as path;
import 'package:path_provider/path_provider.dart';
import 'package:sqflite_common_ffi/sqflite_ffi.dart';
import 'package:sqlite3/sqlite3.dart';

Future<void> initSqlite() async {
  final appDir = await getApplicationDocumentsDirectory();
  final dllTargetPath = path.join(appDir.path, 'sqlite3.dll');
  
  // 从assets复制dll到可访问路径
  final byteData = await rootBundle.load('assets/sqlite3.dll');
  final file = File(dllTargetPath);
  await file.writeAsBytes(byteData.buffer.asUint8List());
  
  // 初始化ffi并指向该dll
  sqfliteFfiInit();
  databaseFactory = databaseFactoryFfi;
  sqlite3.open(dllTargetPath);
}

3. 完善初始化逻辑与错误捕获 #

在应用启动初期完成sqlite初始化，并添加错误日志排查问题：

import 'package:flutter/material.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  try {
    await initSqlite();
    await initDatabase();
  } catch (e, stackTrace) {
    // 打印详细错误信息，打包后可通过日志文件输出或事件查看器排查
    print('数据库初始化失败: $e');
    print(stackTrace);
  }
  
  runApp(const MyApp());
}

4. 权限问题排查 #

不要将数据库放在Program Files等系统受保护目录，这类目录普通用户无写入权限。必须使用path_provider获取的应用专属目录（如C:\Users\[用户名]\AppData\Roaming\[应用名]）。

5. 尝试自动处理依赖的sqlite3_flutter_libs包 #

使用sqlite3_flutter_libs替代手动管理dll，它会自动处理各平台的sqlite依赖打包：

1. 添加依赖：

dependencies:
  sqlite3_flutter_libs: ^0.5.16
  sqflite_common_ffi: ^2.3.2

2. 简化初始化：

import 'package:sqlite3_flutter_libs/sqlite3_flutter_libs.dart';
import 'package:sqflite_common_ffi/sqflite_ffi.dart';
import 'package:path_provider/path_provider.dart';

Future<Database> initDatabase() async {
  // 针对老版本Android的兼容处理，桌面平台可忽略但不影响
  await applyWorkaroundToOpenSqlite3OnOldAndroidVersions();
  
  databaseFactory = databaseFactoryFfi;
  final appDir = await getApplicationDocumentsDirectory();
  final dbPath = '${appDir.path}/app_database.db';
  
  return openDatabase(dbPath, version: 1, onCreate: (db, version) {
    db.execute('CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT)');
  });
}

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