Kotlin中Room数据库报错：kaptDebugKotlin失败与表不存在问题排查

看起来你遇到的问题主要来自两个方面：数据库版本未更新导致的schema不匹配，以及一处语法错误引发的编译失败，下面一步步帮你解决：

1. 修复lambda表达式的语法错误 #

先看你的AppointmentDatabase里的回调代码，这里有个明显的语法错误：

INSTANCE?.let { database -
    scope.launch(Dispatchers.IO) {
        populateDatabase(database.appointmentDao())
    }
}

database -应该改成database ->，这是Kotlin lambda表达式的标准写法，这个错误会直接导致kapt编译失败，也就是你看到的java.lang.reflect.InvocationTargetException的核心原因之一。修复后代码如下：

INSTANCE?.let { database ->
    scope.launch(Dispatchers.IO) {
        populateDatabase(database.appointmentDao())
    }
}

2. 升级数据库版本并处理表结构变更 #

当你修改了Appointment实体的结构（比如添加/删除字段、修改字段类型等），Room需要感知到数据库schema发生了变化，必须升级数据库版本：

• 首先更新@Database注解里的version值，从1改成2：

@Database(entities = [Appointment::class], version = 2, exportSchema = false)
@TypeConverters(Convertors::class)
abstract class AppointmentDatabase : RoomDatabase() {
    // ... 其他代码
}

开发阶段快速解决（销毁重建数据库） #

如果你还在开发测试阶段，不想写复杂的迁移代码，可以让Room在版本升级时销毁旧数据库并重建，只需要在数据库构建器里添加.fallbackToDestructiveMigration()：

val instance = Room.databaseBuilder(
    context.applicationContext,
    AppointmentDatabase::class.java,
    "app1_db"
)
    .fallbackToDestructiveMigration() // 开发时临时使用，正式版慎用
    .addCallback(AppointmentDatabaseCallback(scope)) // 顺便把回调类名从WordDatabaseCallback改成这个，更贴合业务
    .build()

注意：这个方法会清空旧数据库的所有数据，正式上线的应用不要用，需要编写迁移代码。

正式环境迁移方案 #

如果是正式项目，需要编写Migration类来处理表结构变更，比如你这次修改了表结构，就写对应的迁移逻辑：

// 定义从版本1到版本2的迁移规则
val MIGRATION_1_2 = object : Migration(1, 2) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 在这里执行你的表结构修改SQL，比如添加新字段：
        // database.execSQL("ALTER TABLE appointment ADD COLUMN new_field TEXT DEFAULT ''")
        // 根据你实际的表结构修改来写对应的SQL
    }
}

然后在数据库构建器里添加这个迁移规则：

val instance = Room.databaseBuilder(
    context.applicationContext,
    AppointmentDatabase::class.java,
    "app1_db"
)
    .addMigrations(MIGRATION_1_2) // 添加迁移规则
    .addCallback(AppointmentDatabaseCallback(scope))
    .build()

3. 清理并重新构建项目 #

做完上面的修改后，执行以下步骤：

• 点击Android Studio的Build -> Clean Project
• 然后Build -> Rebuild Project
• 最后卸载手机上的旧应用，重新安装测试

额外的代码优化（非必须，但提升可读性） #

• 把回调类WordDatabaseCallback改成AppointmentDatabaseCallback，和数据库类名对应，避免混淆
• 把populateDatabase的参数名从bookDao改成appointmentDao，语义更清晰：

suspend fun populateDatabase(appointmentDao: AppointmentDao) {
    appointmentDao.deleteAll()
}

按照这些步骤操作后，你的问题应该就能解决了。

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