Android Room数据库损坏后会发生什么？该如何做兜底处理？

核心结论 #

默认生产模式下，Room 不会自动删除损坏的数据库文件并重建，当框架检测到数据库损坏时，会直接抛出IllegalStateException，该异常需要开发者自行做兼容处理。

可落地的兜底处理方案 #

1. 使用Room内置损坏回调做统一处理 #

Room 2.2.0及以上版本提供了RoomDatabase.Builder.setCorruptionHandler()方法，可直接自定义数据库损坏时的处理逻辑，参考代码：

val appDatabase = Room.databaseBuilder(
    applicationContext,
    AppDatabase::class.java,
    "your_database_name"
)
.setCorruptionHandler {
    // 此处执行损坏后的恢复逻辑
    // 方案1：有本地备份时优先从备份恢复，降低用户数据丢失概率
    // 方案2：无备份/恢复失败时，删除损坏的数据库文件，后续初始化会自动重建
    applicationContext.deleteDatabase("your_database_name")
}
.build()

2. 按业务场景选择分级恢复策略 #

• 缓存/非核心数据存储场景：如果数据库仅存储接口缓存、本地配置等非用户核心数据，直接删除损坏文件重建即可，用户几乎无感知，最多需要重新拉取一次缓存内容。
• 用户核心数据存储场景：
  • 提前配置自动备份逻辑：在用户空闲时段定期将数据库文件备份到应用沙盒独立目录，合规前提下也可同步到用户云空间，检测到损坏时优先用最新备份恢复
  • 备份恢复失败时再执行删除重建逻辑，可搭配轻量用户提示，告知用户部分本地数据丢失，避免用户产生疑惑

3. 额外兜底机制 #

• 所有数据库操作外层加统一异常捕获，避免损坏异常直接触发应用崩溃，捕获到异常时同步触发恢复逻辑，同时上报埋点统计损坏发生的量级和场景，方便后续排查根因
• App冷启动初始化Room前，可先执行PRAGMA integrity_checkSQL命令校验数据库完整性，提前发现损坏问题，在用户执行具体数据库操作前完成恢复，降低操作中途出错的概率

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