将Room从KAPT迁移到KSP后出现RuntimeException问题求助

之前数据库运行正常，按照官方文档将KAPT迁移到KSP后，Hilt适配正常，但Room库出现RuntimeException，找不到HitsDatabase的实现类HitsDatabase_Impl，网上未找到相关解决办法，求助问题原因。

环境信息 #

• Java版本：11
• Kotlin版本：1.8.10
• Room版本：2.5.2

崩溃日志 #

FATAL EXCEPTION: pool-36-thread-2
Process: com.mypackage.myapp, PID: 3103
java.lang.RuntimeException: Cannot find implementation for com.mypackage.myapp.backend.databasehits.HitsDatabase. HitsDatabase_Impl does not exist
at androidx.room.Room.getGeneratedImplementation(Room.kt:58)
at androidx.room.RoomDatabase$Builder.build(RoomDatabase.kt:1357)
at com.mypackage.myapp.backend.databasehits.HitsDatabase$Companion.getInstance(HitsDatabase.kt:49)
at com.mypackage.myapp.backend.helper.SongHitHelper.getDb(SongHitHelper.kt:12)
at com.mypackage.myapp.backend.helper.SongHitHelper.access$getDb(SongHitHelper.kt:10)
at com.mypackage.myapp.backend.helper.SongHitHelper$getAll$1.invoke(SongHitHelper.kt:16)
at com.mypackage.myapp.backend.helper.SongHitHelper$getAll$1.invoke(SongHitHelper.kt:15)
at com.mypackage.myapp.backend.database.QueryExecutor.executeSync(QueryExecutor.kt:43)
at com.mypackage.myapp.backend.database.DbCall.executeSync(DbCall.kt:27)
at com.mypackage.myapp.backend.database.DbCall.executeAsync$lambda$3(DbCall.kt:90)
at com.mypackage.myapp.backend.database.DbCall.$r8$lambda$XterYYUlFvZeosmE2W9FxI8ZDDY(Unknown Source:0)
at com.mypackage.myapp.backend.database.DbCall$$ExternalSyntheticLambda0.run(Unknown Source:4)

项目级build.gradle配置 #

buildscript{
    ext.kotlin_version = '1.8.10'
}

...

plugins {
    id 'com.google.devtools.ksp' version '1.8.10-1.0.9'
}
...

应用模块build.gradle配置 #

plugins {
    ...
    id 'com.google.devtools.ksp'
    ...
}

...
dependencies {
    // Room
    implementation "androidx.room:room-runtime:${versions.room}"
    ksp "androidx.room:room-compiler:${versions.room}"
...
}

已尝试操作 #

• 清除缓存并重启Android Studio
• 清理项目
• 重新构建项目

添加room-ktx后的构建失败日志 #

> Task :app:kspDebugKotlin
'compileDebugJavaWithJavac' task (current target is 11) and 'kspDebugKotlin' task (current target is 1.8) jvm target compatibility should be set to the same Java version.
By default will become an error since Gradle 8.0+! Read more: https://kotl.in/gradle/jvm/target-validation
Consider using JVM toolchain: https://kotl.in/gradle/jvm/toolchain

w: [ksp] /home/gelson/StudioProjects/AndroidL/MyApp/app/src/main/java/com/mypackage/backend/databasehits/HitsDatabase.kt:19: Schema export directory is not provided to the annotation processor so we cannot export the schema. You can either provide `room.schemaLocation` annotation processor argument OR set exportSchema to false.
e: [ksp] /home/gelson/StudioProjects/AndroidL/MyApp/app/src/main/java/com/mypackage/backend/models/User.kt:5: [MissingType]: Element 'com.mypackage.backend.models.User' references a type that is not present
e: Error occurred in KSP, check log for detail

> Task :app:kspDebugKotlin FAILED
[ksp] /home/gelson/StudioProjects/AndroidL/MyApp/app/src/main/java/com/mypackage/backend/databasehits/HitsDatabase.kt:19: Schema export directory is not provided to the annotation processor so we cannot export the schema. You can either provide `room.schemaLocation` annotation processor argument OR set exportSchema to false.

[ksp] /home/gelson/StudioProjects/AndroidL/MyApp/app/src/main/java/com/mypackage/backend/models/User.kt:5: [MissingType]: Element 'com.mypackage.backend.models.User' references a type that is not present

1. 优先解决构建失败的核心问题 #

构建失败由两个直接原因导致：

• JVM目标版本不匹配：Java编译目标为11，但KSP的Kotlin编译目标为1.8。在应用模块的build.gradle中统一版本：

  android {
      compileOptions {
          sourceCompatibility JavaVersion.VERSION_11
          targetCompatibility JavaVersion.VERSION_11
      }
      kotlinOptions {
          jvmTarget = '11'
      }
  }
  

• MissingType错误：检查User.kt第5行，确认引用的类型是否存在、包名是否正确，排查是否有类被误删、包名拼写错误，或该类所在模块未被正确依赖。

2. 修复Room实现类未生成的问题 #

构建成功后若仍出现HitsDatabase_Impl不存在异常，按以下步骤排查：

• 确认Room注解处理器已替换为KSP：确保依赖中已移除kapt "androidx.room:room-compiler"，仅保留ksp "androidx.room:room-compiler"。
• 配置Room Schema导出（可选但推荐）：在应用模块的android块中添加KSP参数，避免警告同时确保注解处理器正常工作：

  android {
      ...
      ksp {
          arg("room.schemaLocation", "$projectDir/schemas")
      }
  }
  

  或在RoomDatabase类上关闭导出：

  @Database(entities = [...], version = 1, exportSchema = false)
  abstract class HitsDatabase : RoomDatabase() {
      // ...
  }
  

• 重新执行Clean Project -> Rebuild Project，检查build/generated/ksp/debug/kotlin/com/mypackage/myapp/backend/databasehits/目录下是否存在HitsDatabase_Impl类。

3. 关于room-ktx依赖 #

解决上述问题后，可正常添加implementation "androidx.room:room-ktx:${versions.room}"，它提供Room的Kotlin扩展函数，不会影响核心功能。

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