将现有SQLite数据库迁移至Room：原有迁移脚本存放与升级问题

嘿，我来帮你把这个Room迁移的问题掰扯清楚～

核心疑问解答：版本2→3的升级谁负责？ #

答案很明确：必须由Room来负责。当用户从版本2直接升级到4时，Room会自动按顺序执行所有中间版本的迁移脚本——也就是说，它会先跑2→3的迁移，再跑3→4的迁移。所以你不能只写3→4的Migration，必须把原来SqliteOpenHelper里处理2→3升级的逻辑，也转换成Room的Migration对象。

原有迁移脚本该放哪里？ #

你需要为每一个版本跨度单独创建Room的Migration实例，把旧的SQL升级逻辑原封不动（或者适配SQLite通用语法）搬进去：

// 把原来SqliteOpenHelper里v2→v3的升级逻辑复制到这里
val MIGRATION_2_3 = object : Migration(2, 3) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 比如原来的ALTER TABLE、CREATE TABLE这些SQL语句
        database.execSQL("ALTER TABLE `user` ADD COLUMN `nickname` TEXT DEFAULT ''")
        // 其他旧升级脚本里的操作都放这儿
    }
}

// 你已经准备好的v3→v4的Room化迁移
val MIGRATION_3_4 = object : Migration(3, 4) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 你的v3到v4的升级逻辑，比如适配Room的表结构调整
    }
}

然后在初始化RoomDatabase的时候，把所有这些Migration都加进去：

val appDatabase = Room.databaseBuilder(
    context.applicationContext,
    AppDatabase::class.java,
    "your-db-name"
)
    .addMigrations(MIGRATION_2_3, MIGRATION_3_4)
    // 如果还有v1→v2的迁移，也要加对应的MIGRATION_1_2
    .build()

关于JSON Schema缺失导致的失败问题 #

Room依赖JSON Schema文件来验证迁移的正确性，这是它的核心校验机制。解决方法分两步：

1. 开启Schema生成：在你的app模块的build.gradle（或build.gradle.kts）里添加配置，让Room自动生成各版本的Schema：

   android {
       defaultConfig {
           javaCompileOptions {
               annotationProcessorOptions {
                   arguments += ["room.schemaLocation": "$projectDir/schemas".toString()]
               }
           }
       }
   }
   

   配置后重新编译项目，Room会在项目根目录的schemas文件夹下生成每个数据库版本的JSON Schema文件。
2. 补全旧版本Schema：如果原来的v1、v2、v3版本没有Schema，你可以：
   • 临时创建对应版本的实体类（模拟当时的表结构），编译生成对应的Schema文件；
   • 或者手动编写Schema（不推荐，容易出错）。
     要是你暂时不想做Schema验证（仅限应急，不建议长期这么干），可以在RoomDatabase的注解里加上exportSchema = false，但这样会失去Room的迁移校验能力，风险较高。

额外提醒 #

别忘了覆盖所有旧版本的迁移路径——比如如果还有v1→v2的升级逻辑，也要转换成对应的Migration(1,2)，不然用户从v1直接升级到v4时会崩溃。

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