Android Room导入预打包数据库报关联表schema无效错误如何解决？

问题原因 #

报错核心是预打包数据库的交叉表结构与Room期望的结构不匹配，存在两处差异：

• 表名不匹配：Room期望交叉表表名为appointmentUserCrossRef_table，你的预建库中交叉表表名为appointmentUserCrossRef
• 联合主键配置缺失：Room期望appointmentId、userId作为联合主键且字段非空，你的预建交叉表未设置联合主键，导致Room识别到两个字段主键位置为0、非空属性为false

修复步骤 #

1. 修改预填充数据库的交叉表建表语句，替换为以下内容：

CREATE TABLE "appointmentUserCrossRef_table" (
    "appointmentId" INTEGER NOT NULL,
    "userId"    INTEGER NOT NULL,
    PRIMARY KEY("appointmentId", "userId")
);

2. 重新生成预打包的database.db文件，替换项目assets目录下的旧文件
3. 卸载设备上已安装的测试应用后重新运行，避免本地缓存的旧版本数据库导致报错重复出现

额外注意事项 #

• 可将@Database注解中的exportSchema属性改为true，编译项目后会在app/schemas目录下生成对应版本的数据库schema json文件，里面包含Room期望的所有建表语句，直接使用这些语句创建预填充数据库可完全避免schema不匹配问题
• 你的实体类中使用了Bitmap、User、Date类型作为字段，需要确保声明的TypeConverter覆盖了所有这些类型的转换逻辑，否则后续会出现字段解析报错

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