Android中Room数据库迁移崩溃的解决方法（含异常场景）

我之前做Room数据库迁移时也踩过这个坑，你遇到的核心问题是对fallbackToDestructiveMigration()的触发逻辑理解有偏差：这个方法只会在Room找不到对应版本的迁移规则时，才会销毁旧数据库并重建新的。而你已经声明了对应版本的迁移（比如MIGRATION_3_4），所以Room会优先执行迁移逻辑，哪怕迁移过程中因为NOT NULL约束冲突抛出IllegalStateException，它也不会自动触发销毁重建的流程。

下面给你几个可行的解决方案，根据你的需求选择：

方案一：修改迁移规则，先处理NULL值再添加约束（保留数据） #

如果你还想保留现有数据，最稳妥的方式是在迁移时先把字段的NULL值替换成默认值，再添加NOT NULL约束。比如假设你要给your_table表的target_column字段添加NOT NULL约束：

static final Migration MIGRATION_3_4 = new Migration(3, 4) {
    @Override
    public void migrate(@NonNull SupportSQLiteDatabase database) {
        // 先将NULL值替换为合适的默认值（根据字段类型调整，比如文本用空串，数字用0）
        database.execSQL("UPDATE your_table SET target_column = '' WHERE target_column IS NULL");
        // 再添加NOT NULL约束
        database.execSQL("ALTER TABLE your_table MODIFY COLUMN target_column TEXT NOT NULL");
    }
};

这样迁移时先清理掉NULL值，就不会触发约束冲突导致崩溃了。

方案二：强制删除数据库后重建（舍弃所有数据） #

如果你完全不在乎现有数据，只想让应用正常启动，可以通过捕获迁移异常的方式，手动删除数据库后重新构建：

// 建议在子线程中执行数据库操作，避免阻塞主线程
new Thread(() -> {
    try {
        // 首次访问数据库会触发迁移
        mAppDb.yourDao().anyMethod();
    } catch (IllegalStateException e) {
        // 迁移失败，删除旧数据库
        deleteDatabase(DB_NAME);
        // 重新构建数据库实例，此时会创建全新的数据库
        mAppDb = Room.databaseBuilder(getApplicationContext(), AppDatabase.class, DB_NAME)
                .fallbackToDestructiveMigration()
                .build();
        // 再次初始化访问
        mAppDb.yourDao().anyMethod();
    }
}).start();

注意：deleteDatabase()是Context类的方法，需要在Activity或Application的上下文环境中调用。

方案三：指定特定版本触发销毁重建（更简洁的舍弃数据方式） #

如果你确定从某个旧版本（比如版本3）升级到新版本时不想执行迁移，直接销毁重建，可以使用fallbackToDestructiveMigrationFrom()方法，同时移除对应的迁移规则：

mAppDb = Room.databaseBuilder(this, AppDatabase.class, DB_NAME)
        .addMigrations(MIGRATION_1_2, MIGRATION_2_3) // 保留正常的旧迁移
        // 指定从版本3升级时直接销毁重建，不再执行MIGRATION_3_4
        .fallbackToDestructiveMigrationFrom(3)
        .build();

这样当数据库版本为3时，Room会直接删除旧库并创建符合新版本实体类的新数据库，完全跳过迁移流程，自然不会有NOT NULL约束的问题。

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