应用升级时将外部存储DB迁移至内部存储的问题与最优方案咨询

你的问题核心是硬编码内部存储路径导致的目录不存在错误，加上Android版本对存储访问的限制，直接写data/data/...的方式在Android 10及以上是不允许的，而且你手动创建目录的逻辑也没和后续文件路径关联起来。下面是修复后的最优实现方案：

关键问题修正点 #

• 禁止硬编码内部存储路径：Android提供了系统API获取合法的内部数据库路径，避免因系统版本、自定义ROM导致的路径差异。
• 提前验证文件存在性：打开输入流前先检查外部DB文件是否存在，避免空指针或找不到文件的异常。
• 自动管理资源：使用try-with-resources语法自动关闭IO流，杜绝资源泄漏。
• 适配分区存储：针对Android 10+的分区存储特性，调整权限和文件访问逻辑。

完整实现代码 #

public static void migrateDbFromExternalToInternal(Context context, String DATABASE_NAME) {
    // 检查外部存储读取权限
    if (!PermissionUtil.isExternalPermissionGranted()) {
        Log.d("DbMigration", "缺少外部存储读取权限，迁移终止");
        return;
    }

    // 构建外部DB文件对象（根据实际存储路径调整，比如可能在子目录下）
    File externalDbFile = new File(Environment.getExternalStorageDirectory(), DATABASE_NAME);
    if (!externalDbFile.exists()) {
        Log.d("DbMigration", "外部存储中未找到目标数据库文件");
        return;
    }

    // 获取应用内部数据库的合法路径，系统会自动处理目录创建
    File internalDbFile = context.getDatabasePath(DATABASE_NAME);
    File internalDbDir = internalDbFile.getParentFile();
    
    // 保险起见，手动检查并创建目录（getDatabasePath通常会自动创建，但部分场景可能需要）
    if (!internalDbDir.exists() && !internalDbDir.mkdirs()) {
        Log.e("DbMigration", "创建内部数据库目录失败");
        return;
    }

    // 高效复制文件
    try (FileInputStream inputStream = new FileInputStream(externalDbFile);
         FileOutputStream outputStream = new FileOutputStream(internalDbFile, false)) {
        
        // 使用FileChannel实现高速文件复制
        outputStream.getChannel().transferFrom(
            inputStream.getChannel(),
            0,
            inputStream.getChannel().size()
        );
        Log.d("DbMigration", "数据库迁移完成");

        // 可选：迁移成功后删除外部存储的原文件（根据业务需求决定）
        // if (externalDbFile.delete()) {
        //     Log.d("DbMigration", "已清理外部存储原数据库文件");
        // }

    } catch (IOException e) {
        Log.e("DbMigration", "迁移失败: " + e.getMessage(), e);
    }
}

额外注意事项 #

1. 权限适配：
   • Android 10-12：需要动态申请READ_EXTERNAL_STORAGE权限
   • Android 13+：需根据DB文件类型申请READ_MEDIA_IMAGES/READ_MEDIA_VIDEO/READ_MEDIA_AUDIO，如果是自定义格式文件，仍需READ_EXTERNAL_STORAGE（需在manifest中添加android:maxSdkVersion="32"）
2. 迁移时机：
   • 建议在Application.onCreate()中执行：先检查内部DB是否存在，不存在再触发迁移
   • 版本升级场景：通过PackageManager获取当前版本号，与上次保存的版本号对比，首次启动新版本时执行迁移
3. 异常处理：实际项目中可添加用户友好提示（如Toast、弹窗），告知迁移结果

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