You need to enable JavaScript to run this app. 安卓Room多版本数据库迁移报错:表结构校验失败问题排查
优惠活动
大模型
产品
解决方案
定价
更多

安卓Room多版本数据库迁移报错:表结构校验失败问题排查

问题根因

Room在迁移完成后会执行严格的Schema一致性校验:它会比对手写迁移SQL生成的实际数据库结构,和编译期通过@Entity、@Database注解生成的期望结构,二者需要逐字符完全匹配,任何表名、字段名、约束的不一致都会直接触发校验报错。
当前配置的核心矛盾:

  • 实体类通过@Entity(tableName = "result_config")声明,版本7的数据库中对应表的名称是全小写的result_config
  • MIGRATION_6_7的建表SQL里手动使用类名ResultConfig作为表名,二者表名字符串不匹配
    哪怕SQLite本身在部分环境下对表名大小写不敏感,Room的校验逻辑也是严格按字符串匹配的,这种不一致会导致校验时找不到期望表的对应列,触发"表无任何列"的报错。
    之前临时把建表SQL的表名改成remote_config能正常运行,本质是当时同步修改了实体类的tableName注解,让迁移建的表名和Room的期望结构匹配了,并不是因为remote_config这个表名本身有特殊兼容性。
具体修改方案

不需要调整实体类的@Entity注解配置,只需要把迁移逻辑里的建表、删表SQL的表名,统一改成和@Entity注解完全一致的result_config即可,修改后的迁移代码如下:

val MIGRATION_6_7 = object : Migration(6, 7) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 表名严格匹配@Entity声明的result_config
        database.execSQL("CREATE TABLE IF NOT EXISTS result_config(seq INTEGER NOT NULL, json_data TEXT NOT NULL, updated_at TEXT NOT NULL, created_at TEXT NOT NULL, PRIMARY KEY(seq))")
    }
}

val MIGRATION_7_6 = object : Migration(7, 6) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 回退迁移的删表逻辑也要使用相同的表名
        database.execSQL("DROP TABLE IF EXISTS result_config")
    }
}
补充注意事项
  • 给建表语句加IF NOT EXISTS、删表语句加IF EXISTS,可以避免极端场景下(比如迁移逻辑被重复触发、历史残留表)抛出SQL执行异常
  • 如果你开启了exportSchema = true,可以在项目的app/schemas/对应包名/MainDatabase目录下找到版本7对应的7.json文件,里面记录了Room生成的标准建表SQL,你可以对照这个文件调整迁移的建表逻辑,保证字段类型、约束完全匹配,避免后续出现其他校验错误
  • 因为你在主键上设置了@PrimaryKey(autoGenerate = true),对照标准schema检查时,要确认主键的自增约束是否和Room生成的配置一致,避免插入数据时出现主键冲突问题

内容的提问来源于stack exchange,提问作者c-an

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 01:15:04