Room数据库迁移误改表名致崩溃，如何修正避免后续问题？

崩溃原因 #

你发布的新版本中，Room实体类的表名从favoritelist改为favoriteslist，但老用户设备上的数据库仍保留旧表名。Room启动时会校验数据库schema与实体类定义是否匹配，发现预期的favoriteslist表不存在，直接抛出异常导致崩溃。

核心解决方案：必须通过手动迁移处理表名变更 #

Room自动迁移无法识别表名修改这类结构变更，因此必须编写手动迁移代码，同时升级数据库版本号，确保新旧版本用户升级时都能正常适配。

方案1：保留新表名favoriteslist（推荐，避免反复变更）

1. 升级数据库版本号：将Room数据库类的version参数从当前错误版本（比如V2）提升到V3。
2. 编写手动迁移逻辑：在迁移中执行SQL重命名表，把旧表名改为新表名：

val MIGRATION_2_3 = object : Migration(2, 3) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 兼容V1→V3（旧表是favoritelist）和V2→V3（表已是favoriteslist）的情况
        // SQLite允许重命名表到自身，不会触发报错
        database.execSQL("ALTER TABLE favoritelist RENAME TO favoriteslist;")
    }
}

3. 关联迁移到数据库类：在Room数据库的@Database注解中添加该迁移：

@Database(
    entities = [Favorite::class],
    version = 3,
    migrations = [MIGRATION_2_3]
)
abstract class AppDatabase : RoomDatabase() {
    // DAO定义
}

4. 确认实体类表名：确保实体类的@Entity注解中使用的const val是正确的favoriteslist：

const val TABLE_FAVORITES = "favoriteslist"

@Entity(tableName = TABLE_FAVORITES)
data class Favorite(/* 字段定义 */)

方案2：回滚到旧表名favoritelist

如果不想保留新表名，需要把表名改回原名称，同时同样要处理迁移：

1. 将const val改回favoritelist：

const val TABLE_FAVORITES = "favoritelist"

2. 升级数据库版本到V3，并编写迁移逻辑，把V2版本中已创建的favoriteslist表改回旧名称：

val MIGRATION_2_3 = object : Migration(2, 3) {
    override fun migrate(database: SupportSQLiteDatabase) {
        database.execSQL("ALTER TABLE favoriteslist RENAME TO favoritelist;")
    }
}

3. 关联迁移到数据库类，确保版本号和迁移配置正确。

关键注意事项 #

• 不能直接修改表名而不升级数据库版本：Room会缓存schema信息，版本号不变的话，新旧schema不匹配会直接崩溃。
• 必须覆盖所有升级路径：要确保从V1（旧表名）→V3、V2（错误表名）→V3都能正常迁移，上面的SQL语句在表名已正确的情况下不会报错，可兼容两种升级场景。
• 测试验证：一定要在测试环境模拟老版本升级流程，确认迁移后数据不丢失、数据库正常工作。

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