如何为Flutter应用添加Hive数据库的导入导出功能？

1. 先解决存储权限问题 #

Android系统的存储权限限制是常见的失败原因，必须确保应用获得了对应权限：

• 在AndroidManifest.xml中添加权限声明：

  <!-- Android 10及以下版本 -->
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <!-- Android 13+版本 -->
  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
  <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
  <!-- 如需全文件管理权限（可选） -->
  <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
  

• 在代码中动态申请权限（需依赖permission_handler包）：

  import 'package:permission_handler/permission_handler.dart';
  
  // 按钮点击时先检查权限
  bool hasPermission = await Permission.storage.isGranted;
  if (!hasPermission) {
    final status = await Permission.storage.request();
    hasPermission = status.isGranted;
  }
  if (!hasPermission) {
    print("存储权限未授权，无法备份");
    return;
  }
  

2. 修正路径处理与文件复制逻辑 #

你的代码中路径拼接方式错误，且缺少错误捕获与目录存在性检查，替换为以下代码：

ElevatedButton(onPressed: () async{
  try {
    // 权限检查（同上）
    bool hasPermission = await Permission.storage.isGranted;
    if (!hasPermission) {
      final status = await Permission.storage.request();
      hasPermission = status.isGranted;
    }
    if (!hasPermission) {
      print("存储权限未授权");
      return;
    }

    final box = Hive.box<Cart>(cartBoxName);
    final String? pathHive = box.path;
    if (pathHive == null) {
      print("无法获取Hive盒子路径");
      return;
    }

    final Directory dir = Directory('/storage/emulated/0/Download');
    // 确保下载目录存在
    if (!await dir.exists()) {
      await dir.create(recursive: true);
    }
    // 正确拼接目标路径
    final String destPath = '${dir.path}/backup.hive';
    await File(pathHive).copy(destPath);
    print("备份成功，文件路径：$destPath");
  } catch (e) {
    print("备份失败：$e");
  }
})

3. 适配Android 10+的Scoped Storage #

Android 10及以上推荐使用系统API获取公共目录，避免直接硬编码路径，可借助path_provider包：

import 'package:path_provider/path_provider.dart';

// 替换原目录获取逻辑
final Directory? dir = await getExternalStoragePublicDirectory(DirectoryDownloads);
if (dir == null) {
  print("无法获取系统下载目录");
  return;
}

4. 完整数据库备份（可选） #

如果需要备份整个Hive数据库而非单个盒子，可复制Hive的根目录：

// 获取Hive根目录
final appDocDir = await getApplicationDocumentsDirectory();
final hiveDir = Directory('${appDocDir.path}/hive');
// 复制到下载目录
await copyDirectory(hiveDir, Directory('${dir.path}/hive_full_backup'));

// 实现目录复制工具函数
Future<void> copyDirectory(Directory source, Directory destination) async {
  await destination.create(recursive: true);
  for (final entity in await source.list(recursive: false)) {
    if (entity is File) {
      await entity.copy('${destination.path}/${entity.path.split('/').last}');
    } else if (entity is Directory) {
      await copyDirectory(entity, Directory('${destination.path}/${entity.path.split('/').last}'));
    }
  }
}

内容的提问来源于stack exchange，提问作者Hacker M.t.s