嘿，我刚好在项目里实现过sqflite的备份恢复功能，亲测在iOS和Android上都能稳定运行，给你分享具体的实现思路和代码：

核心思路 #

sqflite的数据库本质就是一个本地文件，所以备份恢复的核心就是文件的复制与覆盖，关键在于获取正确的数据库文件路径，以及处理好数据库连接的状态。

准备工作 #

首先需要添加几个依赖到pubspec.yaml：

dependencies:
  sqflite: ^2.3.0 # 可以替换成最新版本
  path_provider: ^2.1.0
  path: ^1.8.3

1. 数据库备份实现 #

备份的步骤很简单：找到当前数据库的位置，复制到指定的备份目录（比如外部存储，方便用户导出或查看）。

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

Future<void> backupDatabase() async {
  try {
    // 1. 获取当前sqflite数据库的默认存储路径
    final dbDirectory = await getDatabasesPath();
    final sourceDbPath = join(dbDirectory, 'your_database_name.db'); // 替换成你的数据库文件名
    final sourceFile = File(sourceDbPath);

    // 2. 选择备份存储的目录（这里用外部存储的Documents，用户可通过文件管理找到）
    final backupDirectory = await getExternalStorageDirectory();
    if (backupDirectory == null) {
      throw Exception('无法访问外部存储，请检查权限');
    }

    // 3. 生成带时间戳的备份文件名，避免覆盖旧备份
    final timestamp = DateTime.now().millisecondsSinceEpoch;
    final backupFilePath = join(backupDirectory.path, 'db_backup_$timestamp.db');
    final backupFile = File(backupFilePath);

    // 4. 复制数据库文件到备份路径
    await sourceFile.copy(backupFile.path);
    print('备份成功！备份文件路径：$backupFilePath');
    // 这里可以给用户弹个提示，告知备份完成
  } catch (e) {
    print('备份失败：$e');
    // 处理错误，比如提示用户检查存储权限
  }
}

权限注意事项 #

• Android：需要在android/app/src/main/AndroidManifest.xml中添加权限：

  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  

  并且在Android 6.0+需要动态申请权限，可以用permission_handler插件实现。

• iOS：如果要让用户通过“文件”App访问备份文件，需要在Info.plist中添加：

  <key>LSSupportsOpeningDocumentsInPlace</key>
  <true/>
  <key>UIFileSharingEnabled</key>
  <true/>
  

2. 数据库恢复实现 #

恢复的关键是先关闭当前数据库连接，否则原数据库文件被占用无法覆盖，之后再用备份文件替换原文件，最后重新打开数据库。

Future<void> restoreDatabase(String backupFilePath) async {
  try {
    // 1. 检查备份文件是否存在
    final backupFile = File(backupFilePath);
    if (!await backupFile.exists()) {
      throw Exception('备份文件不存在');
    }

    // 2. 关闭当前数据库连接（非常重要！否则无法覆盖文件）
    // 假设你的数据库实例是`database`，替换成你自己的实例变量
    await database.close();

    // 3. 获取原数据库的路径
    final dbDirectory = await getDatabasesPath();
    final targetDbPath = join(dbDirectory, 'your_database_name.db');
    final targetFile = File(targetDbPath);

    // 4. 用备份文件覆盖原数据库文件
    await backupFile.copy(targetFile.path);

    // 5. 重新打开数据库
    database = await openDatabase(targetDbPath);
    print('恢复成功！');
    // 提示用户恢复完成，可能需要重启页面刷新数据
  } catch (e) {
    print('恢复失败：$e');
    // 恢复失败后重新打开原数据库，避免App崩溃
    database = await openDatabase(join(await getDatabasesPath(), 'your_database_name.db'));
  }
}

优化建议 #

• 用file_picker插件让用户选择备份文件，不用手动输入路径，体验更好。
• 备份前可以暂停数据库写入操作，避免备份损坏的文件。
• 恢复前一定要给用户弹出确认对话框，明确提醒会覆盖现有数据。

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