如何修改Room DB预期列顺序？预打包数据库架构无效报错

问题概述 #

预填充Room数据库时触发Pre-packaged database has an invalid schema错误，使用SQLite浏览器创建数据库时也存在相同问题。（exportSchema未导出架构的问题可忽略）

报错详情 #

Expected:
TableInfo{name='words', columns={en=Column{name='en', type='TEXT', affinity='2', notNull=false, primaryKeyPosition=0, defaultValue='undefined'}, id=Column{name='id', type='INTEGER', affinity='3', notNull=true, primaryKeyPosition=1, defaultValue='undefined'}, pl=Column{name='pl', type='TEXT', affinity='2', notNull=false, primaryKeyPosition=0, defaultValue='undefined'}, speech=Column{name='speech', type='TEXT', affinity='2', notNull=false, primaryKeyPosition=0, defaultValue='undefined'}}, foreignKeys=[], indices=[]}
Found:
TableInfo{name='words', columns={id=Column{name='id', type='INTEGER', affinity='3', notNull=false, primaryKeyPosition=1, defaultValue='undefined'}, en=Column{name='en', type='TEXT', affinity='2', notNull=false, primaryKeyPosition=0, defaultValue='undefined'}, pl=Column{name='pl', type='TEXT', affinity='2', notNull=false, primaryKeyPosition=0, defaultValue='undefined'}, speech=Column{name='speech', type='TEXT', affinity='2', notNull=false, primaryKeyPosition=0, defaultValue='undefined'}}, foreignKeys=[], indices=[]}

核心差异分析 #

从报错对比可提取两个关键不匹配点：

1. 非空约束不一致：Room预期id列notNull=true，但预填充库中id列notNull=false
2. 列顺序不一致：Room预期列顺序为en→id→pl→speech，预填充库中为id→en→pl→speech

Room对预填充库的架构校验严格，即便SQLite本身不关心列顺序，Room仍会将其与实体类生成的架构做精确匹配，包括约束、顺序等细节。

当前代码与建表语句 #

实体类代码 #

@Entity(tableName = "words")
data class MyEntity (
    @PrimaryKey
    @ColumnInfo(name = "id")val id: Int,
    @ColumnInfo(name = "en") val englishWord: String?,
    @ColumnInfo(name = "pl") val polishWord: String?,
    @ColumnInfo(name = "speech") val speech: String?
)

原建表SQL #

CREATE TABLE words (id INTEGER PRIMARY KEY, en TEXT, pl TEXT, speech TEXT)

解决方案 #

方案1：修正预填充库的架构（推荐） #

1. 导出Room官方架构：确保模块build.gradle中开启exportSchema：

   android {
       ...
       room {
           exportSchema = true
       }
   }
   

   编译项目后，在app/build/generated/source/room/schema目录下会生成JSON格式的架构文件，其中包含Room预期的完整表定义。
2. 重构预填充库：参考导出的schema文件中的表定义，重新创建SQLite数据库，确保id列显式添加NOT NULL约束，并且列顺序与Room预期一致。修正后的建表语句示例：

   CREATE TABLE words (en TEXT, id INTEGER PRIMARY KEY NOT NULL, pl TEXT, speech TEXT)
   

方案2：调整实体类匹配现有预填充库 #

如果无需重构预填充库，可修改实体类将id改为可空类型，让Room生成的架构匹配现有库的非空约束：

@Entity(tableName = "words")
data class MyEntity (
    @PrimaryKey
    @ColumnInfo(name = "id")val id: Int?, // 修改为可空类型
    @ColumnInfo(name = "en") val englishWord: String?,
    @ColumnInfo(name = "pl") val polishWord: String?,
    @ColumnInfo(name = "speech") val speech: String?
)

注意：此方案可能影响业务逻辑，需谨慎评估。

方案3：禁用架构校验（不推荐） #

Room无官方开关忽略架构校验，强行绕过会破坏数据一致性，不建议使用。

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