如何导出/导入基于Android Jetpack-Compose应用的Room SQLite数据库？

核心结论 #

完全可以。Room本质是SQLite的上层封装，它的底层存储文件就是标准的SQLite格式（通常文件名是你定义的数据库名，比如app_database.db，本质就是.sqlite文件），直接操作这个文件就能实现导出/导入。

具体实现方式 #

1. 手动导出/导入（调试阶段使用） #

借助Android Studio的Device File Explorer就能快速操作：

• 打开View > Tool Windows > Device File Explorer
• 定位到应用的数据库路径：/data/data/[你的应用包名]/databases/
• 目录下的.db文件就是Room对应的SQLite数据库，右键选择Save As可导出到本地；也可以将本地的.sqlite文件拖入该目录完成导入
• 注意：该方式仅适用于调试版应用，正式版应用因沙箱权限限制，无法直接访问此路径

2. 代码实现导出/导入（面向用户的功能） #

如果要在应用内提供导出/导入功能，需处理文件权限和复制逻辑：

导出逻辑示例

fun exportDatabase(context: Context) {
    val dbPath = context.getDatabasePath("app_database.db").absolutePath
    val exportDir = File(context.getExternalFilesDir(null), "database_backups")
    if (!exportDir.exists()) exportDir.mkdirs()
    
    val exportFile = File(exportDir, "backup_${System.currentTimeMillis()}.sqlite")
    
    try {
        FileInputStream(dbPath).use { input ->
            FileOutputStream(exportFile).use { output ->
                input.copyTo(output)
            }
        }
        // 此处可添加导出成功的用户提示
    } catch (e: IOException) {
        // 处理文件复制异常
    }
}

• 权限说明：Android 10及以上无需申请WRITE_EXTERNAL_STORAGE权限，直接写入应用外部专属目录即可；低版本需提前申请对应权限

导入逻辑示例

fun importDatabase(context: Context, importFile: File) {
    val dbPath = context.getDatabasePath("app_database.db").absolutePath
    
    // 必须先关闭数据库连接，避免文件被占用
    val dbInstance = AppDatabase.getInstance(context)
    dbInstance.close()
    
    try {
        FileInputStream(importFile).use { input ->
            FileOutputStream(dbPath).use { output ->
                input.copyTo(output)
            }
        }
        // 导入成功后建议重启应用，让Room重新加载数据库
    } catch (e: IOException) {
        // 处理异常，可考虑恢复原数据库文件
    }
}

• 关键注意点：导入前必须关闭当前Room数据库实例，否则会因文件被占用导致复制失败；导入完成后重启应用能保证Room正确加载新数据库

3. 重要注意事项 #

• 版本兼容性：导入的.sqlite文件必须与当前应用的Room实体类结构、数据库版本完全匹配，否则会触发Room的迁移逻辑，可能导致数据损坏或数据库无法打开
• 数据一致性：导出操作尽量避开数据库写入过程，确保导出的文件处于完整一致的状态
• 权限适配：不同Android版本的存储权限逻辑有差异，需针对Scoped Storage（Android 10+）做适配

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