Flutter Android端现有SQLite数据库连接失败求助

问题根源 #

你的代码和文件配置存在三个核心问题：

1. 数据库文件位置错误：lib目录下的文件不会被打包到应用的assets资源中，Flutter无法通过rootBundle访问该路径的文件。
2. Assets路径配置错误：代码中rootBundle.load('android_studio_project/assets/source.db')使用了本地电脑的绝对路径，而非Flutter Assets的相对路径。
3. 空数据库残留问题：第一次运行时因路径错误导致拷贝失败，生成了空数据库文件，后续检查存在时直接使用该空库，无法触发重新拷贝。

解决方案步骤 #

1. 调整数据库文件位置并配置pubspec.yaml #

• 在项目根目录创建assets/db文件夹，将source.db从lib目录移动到assets/db下。
• 打开pubspec.yaml，添加Assets资源声明（注意缩进格式）：

flutter:
  assets:
    - assets/db/source.db

2. 修正sqLite_connect.dart代码 #

以下是修正后的完整代码，关键调整点已标注：

import 'dart:typed_data';
import 'package:flutter/services.dart';
import 'package:path_provider/path_provider.dart';
import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';
import 'dart:io';

class SqliteConnect {
  static final SqliteConnect instance = SqliteConnect._init();

  SqliteConnect._init();

  Database? _database;

  Future<Database> get database async {
    if (_database != null) return _database!;

    _database = await _initDB('source.db');
    return _database!;
  }

  Future<Database> _initDB(String filePath) async {
    Directory documentsDirectory = await getApplicationDocumentsDirectory();
    String path = join(documentsDirectory.path, filePath);

    bool dbExists = await _checkDbExists(path);

    if (!dbExists) {
      await _copyDbFromAssets(path);
    } else {
      // 额外检查：如果现有数据库为空，删除后重新拷贝
      File dbFile = File(path);
      if (await dbFile.length() == 0) {
        await dbFile.delete();
        await _copyDbFromAssets(path);
      }
    }

    return await openDatabase(
      path,
      version: 1, // 添加版本号，方便后续数据库升级
      // 如果需要数据库升级，可以添加onUpgrade回调
      // onUpgrade: (db, oldVersion, newVersion) {},
    );
  }

  Future<bool> _checkDbExists(String path) async {
    try {
      return await File(path).exists();
    } catch (e) {
      return false;
    }
  }

  Future<void> _copyDbFromAssets(String path) async {
    // 修正Assets路径：使用相对于assets目录的相对路径
    ByteData data = await rootBundle.load('assets/db/source.db');
    List<int> bytes = data.buffer.asUint8List(data.offsetInBytes, data.lengthInBytes);
    await File(path).writeAsBytes(bytes, flush: true);
  }
}

关键修正说明 #

• 修正了rootBundle.load的路径，改为正确的Assets相对路径。
• 添加了空数据库检查逻辑：如果沙盒中的数据库文件大小为0（空库），则删除后重新拷贝预填充数据库。
• 为openDatabase添加了版本号，为后续数据库结构升级预留接口。

Flutter SQLite相关技术建议 #

1. 预填充数据库标准流程：Flutter应用无法直接访问项目目录中的文件，必须将预填充数据库放在assets目录并配置pubspec.yaml，再通过rootBundle读取后拷贝到应用沙盒目录（如getApplicationDocumentsDirectory()返回的路径），这是唯一合法的预填充方式。
2. 懒加载的必要性：数据库连接是资源密集型操作，懒加载（即get database的实现方式）能避免应用启动时不必要的资源消耗，是Flutter SQLite开发的标准实践。
3. 数据库升级管理：如果后续需要修改数据库表结构，需在openDatabase中指定version参数，并实现onUpgrade回调，处理版本迁移逻辑。
4. 调试技巧：可以通过Android Studio的Device File Explorer查看应用沙盒中的数据库文件，路径为/data/data/你的应用包名/files/source.db，也可以导出文件到本地验证数据是否正确拷贝。
5. 权限注意：应用沙盒目录是私有路径，无需申请额外权限；如果需要访问外部存储的数据库，需申请READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE权限，但预填充场景不建议这么做。

内容的提问来源于stack exchange，提问作者Максим Берёзов