SQLite无法打开目标数据库文件，如何修复SqfliteFfiException异常？

SQLite错误码14本质是无法访问目标数据库文件，可能是路径、权限、目录存在性或文件占用问题，以下是逐一排查修复的步骤：

• 检查数据库路径的正确性
  不要硬编码路径，尤其是跨平台场景下（Flutter/React Native等），务必使用框架提供的标准API获取应用可访问的目录。以Flutter为例：

  import 'package:path_provider/path_provider.dart';
  import 'package:sqflite/sqflite.dart';
  import 'package:path/path.dart';
  
  Future<Database> initDB() async {
    // 获取应用私有文档目录（跨平台通用，无需额外权限）
    final appDir = await getApplicationDocumentsDirectory();
    // 拼接数据库文件路径
    final dbPath = join(appDir.path, 'app_database.db');
    return openDatabase(dbPath, version: 1, onCreate: (db, ver) {
      // 执行表创建逻辑
      db.execute('CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT)');
    });
  }
  

  同时要避免路径中包含特殊字符、空格，防止转义或解析错误。

• 确认目录读写权限

  • Android：优先使用应用私有目录（如上述getApplicationDocumentsDirectory()返回的路径），这类目录默认拥有读写权限，无需在AndroidManifest.xml中申请额外权限；如果必须使用外部存储，需申请WRITE_EXTERNAL_STORAGE并适配Android 10+的Scoped Storage规则。
  • iOS：应用私有目录默认开放读写权限，无需在Info.plist中配置权限。
    可以先尝试在目标目录创建一个空文件，验证是否具备写入权限：

  final testFile = File(join(appDir.path, 'test.txt'));
  await testFile.writeAsString('test');
  

• 确保数据库所在目录已存在
  打开数据库前，先递归创建目标目录，避免父目录不存在导致无法生成数据库文件：

  final appDir = await getApplicationDocumentsDirectory();
  if (!await appDir.exists()) {
    await appDir.create(recursive: true);
  }
  

• 排查文件锁定或占用问题

  • 检查是否有未关闭的数据库连接，确保每次使用完数据库后调用await db.close()释放资源；
  • 重启应用或模拟器，清除可能存在的文件占用；
  • 如果是多线程/多进程场景，确保同一时间只有一个进程访问数据库文件。

• 修复或重建损坏的数据库文件
  如果数据库文件本身损坏，可尝试删除旧文件后重建：

  final dbPath = join(appDir.path, 'app_database.db');
  final dbFile = File(dbPath);
  if (await dbFile.exists()) {
    await dbFile.delete();
  }
  // 重新初始化数据库，触发onCreate创建新表
  final db = await openDatabase(dbPath, version: 1, onCreate: ...);
  

  注意：操作前请备份重要数据。

内容的提问来源于stack exchange，提问作者118 Muhammmad Alvin