Android Room数据库版本存储及降级迁移触发问题咨询

一、从版本2升级到3时全新安装数据库 #

直接使用Room提供的破坏性迁移API，精准指定从版本2升级时触发数据库重建：

Room.databaseBuilder(context, AppDatabase::class.java, "your-db-name")
    .createFromAsset("databases/v3.db") // 指定版本3的预打包数据库
    .fallbackToDestructiveMigrationFrom(2) // 仅针对从版本2升级到3的场景执行破坏性重建
    .build()

此方法会直接删除版本2的旧数据库，重新创建并加载版本3的预打包库，无需编写复杂的迁移逻辑。

二、预打包数据库的版本与identifier_string说明 #

• 预打包的.db文件本身不存储数据库版本号，版本完全由你在代码中@Database(version = 3)注解声明的值控制。
• 你看到的identifier_string是Room生成的schema哈希校验值，只要预打包库的表结构、字段定义等与当前代码中@Database关联的实体类完全匹配，这个字符串就会保持一致，和版本号无关。
• 文档中提到的「版本3的预打包数据库文件」，指的是结构符合代码中版本3 schema定义的预打包文件，和文件内部是否存储版本号没有关系。

三、仅添加数据（无schema变更）时触发更新 #

Room的版本号变更逻辑仅响应schema结构的变化，如果只是预打包库中新增了数据（表结构未变），单纯修改版本号不会触发更新——因为Room会检测到schema哈希值一致，不会执行迁移或重建操作。

推荐两种解决方案：

方案1：通过数据库回调手动同步数据 #

新增一个存储数据版本的表（比如metadata），在数据库打开时对比本地数据版本和预打包库的数据版本，手动插入新增内容：

val dbCallback = object : RoomDatabase.Callback() {
    override fun onOpen(db: SupportSQLiteDatabase) {
        super.onOpen(db)
        // 查询本地当前数据版本
        val currentDataVersion = db.query("SELECT data_version FROM metadata").use { cursor ->
            if (cursor.moveToFirst()) cursor.getInt(0) else 0
        }
        // 如果本地数据版本低于目标版本，执行新增数据操作
        if (currentDataVersion < 3) {
            db.execSQL("INSERT INTO products (id, name) VALUES (?, ?)", arrayOf(4, "新增产品"))
            db.execSQL("UPDATE metadata SET data_version = 3")
        }
    }
}

Room.databaseBuilder(context, AppDatabase::class.java, "your-db-name")
    .createFromAsset("databases/v3.db")
    .addCallback(dbCallback)
    .build()

方案2：临时修改schema触发版本升级（不推荐） #

故意对schema做微小修改（比如新增一个临时空表），触发版本号变更，让Room重新复制预打包数据库。但这种方法会导致数据库重建，用户本地修改的数据会丢失，仅适用于无用户自定义数据的场景。

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