如何在Android应用卸载重装后保留Room数据库？

Android应用卸载时，系统会默认删除应用私有目录下的所有数据，而Room数据库默认存储在这个私有目录里，所以卸载重装后数据会丢失。下面是几种可行的解决方案：

方案1：使用Android Auto Backup功能 #

这是Google官方提供的自动备份机制，无需大量代码改动就能实现数据跨重装保留。

• 核心逻辑：系统自动把应用私有数据（包括Room数据库）备份到Google云端，用户重装应用时，只要登录同一Google账号，系统会自动恢复备份数据。
• 配置步骤：
  1. 在AndroidManifest.xml中明确开启备份（默认已开启，可显式配置）：

     <application
         ...
         android:allowBackup="true"
         android:fullBackupContent="@xml/backup_rules">
     </application>
     

  2. 在res/xml目录下创建backup_rules.xml，指定要备份的数据库文件：

     <?xml version="1.0" encoding="utf-8"?>
     <full-backup-content>
         <include domain="database" path="your_database_name.db"/>
         <!-- 可选：备份数据库的wal和shm日志文件，保证数据完整性 -->
         <include domain="database" path="your_database_name.db-wal"/>
         <include domain="database" path="your_database_name.db-shm"/>
     </full-backup-content>
     

• 注意：该功能依赖Google服务，国内用户可能无法正常使用；备份有延迟，且用户可在系统设置中关闭备份。

方案2：将Room数据库存储到外部公共存储 #

把数据库文件放到外部存储的公共目录（比如系统的Documents目录），这样卸载应用时，外部公共目录的文件不会被删除。

• 配置Room时指定外部路径：

  // 获取外部公共Documents目录
  val externalDocsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS)
  // 拼接数据库文件路径
  val dbFilePath = File(externalDocsDir, "your_app_database.db").absolutePath
  
  // 创建Room数据库实例
  val yourDatabase = Room.databaseBuilder(
      context.applicationContext,
      YourDatabase::class.java,
      dbFilePath
  ).build()
  

• 注意事项：
  • 权限适配：Android 10+需要处理分区存储或申请MANAGE_EXTERNAL_STORAGE权限；Android 9及以下需要READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限。
  • 数据安全：外部公共目录的文件可被用户手动删除或其他应用访问，安全性较低。
  • 异常处理：要考虑存储不可用的情况（比如SD卡被移除）。

方案3：云端同步备份 #

定期把Room数据库的数据同步到云端服务器（比如Firebase Realtime Database、自建后端），重装应用后从云端拉取数据恢复。

• 实现思路：
  • 在应用启动、数据更新时，将本地数据同步到云端。
  • 重装应用后，先检查云端是否有备份，有则下载并写入Room数据库。
• 优势：不受设备限制，用户换设备也能恢复数据；配合加密的话，数据安全性更高。
• 注意：需要处理网络异常、数据冲突等问题，开发复杂度有所增加。

方案4：手动备份到外部非私有目录（不推荐） #

在应用运行时定期把数据库备份到外部存储的非私有目录（比如/sdcard/YourAppBackup/），重装后手动或自动检测备份文件恢复。

• 备份示例代码：

  fun backupRoomDatabase(context: Context) {
      // 获取本地Room数据库文件路径
      val dbFile = context.getDatabasePath("your_database_name.db")
      // 创建备份目录
      val backupDir = File(Environment.getExternalStorageDirectory(), "YourAppBackup")
      if (!backupDir.exists()) backupDir.mkdirs()
      // 备份主数据库文件
      val backupDbFile = File(backupDir, "app_db_backup.db")
      dbFile.copyTo(backupDbFile, overwrite = true)
      // 备份数据库的wal和shm文件（保证数据完整性）
      val walFile = File(context.filesDir.parent + "/databases/your_database_name.db-wal")
      val shmFile = File(context.filesDir.parent + "/databases/your_database_name.db-shm")
      walFile.copyTo(File(backupDir, "app_db_backup.db-wal"), overwrite = true)
      shmFile.copyTo(File(backupDir, "app_db_backup.db-shm"), overwrite = true)
  }
  

• 恢复时把备份文件复制回应用的数据库目录即可，但要处理权限和文件覆盖问题，这种方式依赖用户操作或自动检测，稳定性不如前几种方案。

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