使用Jetpack Compose、Room和Dagger-Hilt的Android应用崩溃问题求解

问题背景 #

开发基于Jetpack Compose、Room和Dagger-Hilt的Android应用时，遇到两个核心问题：

1. 应用启动崩溃，抛出异常：java.lang.RuntimeException: Cannot find implementation for com.pbpu.android.data.local.source.Database. Database_Impl does not exist
2. 将Room编译依赖从KSP改为Kapt后，编译失败，报错：Type of the parameter must be a class annotated with @Entity or a collection/array of it，指向RecordWithMarkings类。

解决方案 #

1. 修复Room Database配置，确保KSP生成实现类 #

Room生成Database_Impl的前提是你的Database抽象类完全符合要求：

• 必须添加@Database注解，明确指定entities数组包含所有关联实体（Record::class、Marking::class），并设置数据库版本。
• 类必须是抽象类，继承自RoomDatabase。
• 提供抽象方法返回对应的Dao接口。

示例正确的Database类实现：

@Database(
    entities = [Record::class, Marking::class],
    version = 1,
    exportSchema = false // 根据需求选择是否启用Schema导出
)
abstract class Database : RoomDatabase() {
    abstract fun recordDao(): RecordDao
    abstract fun markingDao(): MarkingDao
}

同时，必须在模块级build.gradle.kts中启用KSP插件，否则KSP无法生成Room的实现代码：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.devtools.ksp") // 关键：启用KSP插件
    id("com.google.dagger.hilt.android")
}

2. 修正Dao中RecordWithMarkings的错误用法 #

RecordWithMarkings是用于查询关联数据的数据类（仅用@Embedded和@Relation标注，无@Entity注解），不能作为@Insert/@Update/@Delete等操作的参数，Room仅支持对@Entity标注的实体类执行增删改操作。

如果你的Dao中有类似错误代码：

@Insert
suspend fun insertRecordWithMarkings(entity: RecordWithMarkings) // 错误：操作非Entity类

需要拆分为原子操作，并用事务保证数据一致性：

@Transaction
suspend fun insertRecordWithMarkings(record: Record, markings: List<Marking>) {
    // 先插入Record，获取自动生成的主键ID
    val recordId = insertRecord(record)
    // 为所有Marking设置外键关联
    val updatedMarkings = markings.map { it.copy(fkIdRecord = recordId) }
    // 批量插入Marking
    insertMarkings(updatedMarkings)
}

@Insert
suspend fun insertRecord(record: Record): Long // 返回插入后的Record主键ID

@Insert
suspend fun insertMarkings(markings: List<Marking>)

3. 清理并重建项目 #

完成上述修改后，执行清理重建操作，确保KSP生成最新的实现代码：

• 在Android Studio中点击Build > Clean Project，再点击Build > Rebuild Project
• 或使用命令行执行：./gradlew clean build

4. 验证依赖版本兼容性 #

确保KSP版本与Kotlin版本严格匹配：你的项目中Kotlin 1.8.10对应KSP 1.8.10-1.0.9，版本匹配；Room 2.5.2也兼容该Kotlin版本，无需调整。

内容的提问来源于stack exchange，提问作者dev.tejasb