Android Room数据库修改Entity类字段后崩溃如何解决？

嘿，这个问题我碰过好多次了——Room对数据库 schema 的变化特别敏感，你给Entity加了新字段但没处理好数据库版本和迁移的话，肯定会崩。咱们一步步来解决：

核心崩溃原因 #

你新增Entity字段后，本地已存在的旧数据库表结构并没有同步更新，但Room自动生成的Dao_Impl类会按照新的Entity结构去执行数据库操作，这就导致了表结构不匹配，通常会抛出SQLite相关的异常（比如no such column这类错误）。

分场景解决方案 #

一、开发阶段（可清空测试数据） #

如果还在开发测试阶段，不在乎之前的测试数据，最简单的两种办法：

• 直接卸载重装App：旧的数据库文件会被彻底删除，Room会根据新的Entity自动创建全新的表结构
• 开启破坏性迁移：在Database类的构建器里添加fallbackToDestructiveMigration()，这样当Room检测到版本变化且无对应迁移规则时，会自动删除旧库并重建。示例代码：

@Database(entities = [YourEntity::class], version = 2) // 版本号必须比原来高！
abstract class AppDatabase : RoomDatabase() {
    abstract fun yourDao(): YourDao

    companion object {
        fun getInstance(context: Context): AppDatabase {
            return Room.databaseBuilder(context, AppDatabase::class.java, "app_db")
                .fallbackToDestructiveMigration() // 开启破坏性迁移
                .build()
        }
    }
}

注意：这个方法会丢失所有本地数据，只适合开发阶段用！

二、生产阶段（需保留用户数据） #

如果App已经上线，必须保留用户的本地数据，那就要编写**数据库迁移（Migration）**规则：

1. 升级数据库版本号：把@Database注解里的version值从原来的数字（比如1）改成更高的数字（比如2）
2. 创建Migration类：定义从旧版本到新版本的迁移逻辑，也就是执行SQL给对应表新增字段。比如你给User表加了一个可空的age字段：

val MIGRATION_1_2 = object : Migration(1, 2) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 执行ALTER TABLE语句新增字段，要和Entity里的定义完全匹配
        database.execSQL("ALTER TABLE User ADD COLUMN age INTEGER")
        // 如果字段需要默认值且不允许为空，可写成：ALTER TABLE User ADD COLUMN age INTEGER DEFAULT 0 NOT NULL
    }
}

3. 添加迁移规则到Database构建器：

fun getInstance(context: Context): AppDatabase {
    return Room.databaseBuilder(context, AppDatabase::class.java, "app_db")
        .addMigrations(MIGRATION_1_2) // 加入自定义的迁移规则
        .build()
}

额外排查要点 #

• 确认Entity新增字段的注解是否正确：比如用@ColumnInfo自定义列名的话，迁移SQL里的列名要和name属性一致
• 查看Dao_Impl的报错详情：错误信息里通常会有具体的SQL异常（比如找不到某个列），能帮你快速定位是迁移语句写错了，还是版本号没更新

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