Room实现一对多关系时遇Pre-packaged database schema无效错误

错误核心原因 #

从报错日志能明确看到：你定义的Workout实体已经添加了指向DailyWorkout的外键约束，但实际预打包/已安装的数据库中，Workout表没有这个外键配置，Room的schema校验机制发现预期结构和实际数据库结构不一致，抛出异常。

解决方案 #

1. 处理预打包数据库文件（如果项目使用了assets中的预打包DB） #

如果你的项目是用预打包数据库作为初始数据，需要手动更新这个DB的结构：

• 用SQLite可视化工具（比如SQLiteStudio）打开assets目录下的数据库文件
• 执行SQL语句添加外键约束：

  ALTER TABLE Workout 
  ADD CONSTRAINT fk_workout_dailyworkout 
  FOREIGN KEY (parentDailyId) REFERENCES DailyWorkout(dailyId) ON DELETE CASCADE;
  

• 保存修改后的DB文件，替换原来的预打包文件

2. 数据库版本迁移（针对已安装App的用户数据兼容） #

如果是已发布的App需要兼容旧版本数据库，必须通过Room迁移来更新结构：

• 第一步：升级数据库版本号
  打开你的Room数据库类，把version参数加1：

  @Database(
      entities = [DailyWorkout::class, Workout::class, WorkoutSetInfo::class],
      version = 2 // 原版本是1，这里改成2
  )
  abstract class YourDatabase : RoomDatabase() {
      // DAO定义
  }
  

• 第二步：编写迁移逻辑
  创建Migration类，实现从版本1到2的结构更新：

  val MIGRATION_1_2 = object : Migration(1, 2) {
      override fun migrate(database: SupportSQLiteDatabase) {
          // 给Workout表添加外键约束
          database.execSQL(
              """
              ALTER TABLE Workout 
              ADD CONSTRAINT fk_workout_dailyworkout 
              FOREIGN KEY (parentDailyId) REFERENCES DailyWorkout(dailyId) ON DELETE CASCADE
              """.trimIndent()
          )
      }
  }
  

• 第三步：在数据库构建时添加迁移

  val db = Room.databaseBuilder(
      context.applicationContext,
      YourDatabase::class.java,
      "workout_log_db" // 你的数据库名称
  )
  .addMigrations(MIGRATION_1_2)
  .build()
  

3. 开发测试阶段快速方案（数据可丢失场景） #

如果是本地开发测试，不需要保留旧数据，可以开启破坏性迁移，让Room直接删除旧数据库并创建新结构：

val db = Room.databaseBuilder(
    context.applicationContext,
    YourDatabase::class.java,
    "workout_log_db"
)
.fallbackToDestructiveMigration() // 仅开发环境使用
.build()

额外注意事项 #

• 确保DailyWorkout实体在@Database的entities数组中排在Workout前面，Room会按这个顺序创建表，避免外键引用的表不存在的问题
• 检查实体类字段的约束（比如非空、类型）和数据库实际结构一致，报错日志中显示字段的约束是匹配的，这部分无需调整

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