Android Kotlin应用中Room Database实现找不到的问题求助

运行Android Kotlin应用时触发如下错误：

java.lang.RuntimeException: Unable to start activity ComponentInfo{com.example.miauto/com.example.miauto.LoginActivity}: java.lang.RuntimeException: Cannot find implementation for com.example.AppDatabase. AppDatabase_Impl does not exist

相关代码如下：

模块级build.gradle.kts #

val room_version = "2.5.0"

implementation("androidx.room:room-runtime:$room_version")
annotationProcessor("androidx.room:room-compiler:$room_version")
implementation("androidx.room:room-ktx:$room_version")
// ... (其他依赖)

LoginActivity.kt #

// ... (导入)

class LoginActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // ...

        val vehiculos = listOf(
            // ... (车辆列表)
        )

        val db = Room.databaseBuilder(
            applicationContext,
            AppDatabase::class.java, "vehiculos"
        ).build()

        val vehiculoDao = db.vehiculoDao()

        for (vehiculo in vehiculos) {
            vehiculoDao.InsertarVehiculo(vehiculo)
        }

        val todosLosVehiculos = vehiculoDao.ObtenerVehiculos()

        for (vehiculo in todosLosVehiculos) {
            println("ID: ${vehiculo.id}, Marca: ${vehiculo.marca}, Modelo: ${vehiculo.modelo}, Tipo: ${vehiculo.tipo}")
        }
    }
}

AppDatabase.kt #

// ... (导入)

@Database(entities = [Vehiculo::class], version = 1, exportSchema = false)
abstract class AppDatabase : RoomDatabase() {
    abstract fun vehiculoDao(): DAOvehiculo
}

DAOvehiculo.kt #

// ... (导入)

@Dao
interface DAOvehiculo {
    @Query("SELECT * FROM vehiculo")
    fun ObtenerVehiculos(): List<Vehiculo>

    @Insert
    fun InsertarVehiculo(vehiculo: Vehiculo)
}

完整Logcat日志：

2023-12-10 18:51:16.432 17503-17503 AndroidRuntime          com.example.miauto                   D  Shutting down VM 2023-12-10 18:51:16.437 17503-17503 AndroidRuntime          com.example.miauto                   E  FATAL EXCEPTION: main Process: com.example.miauto, PID: 17503 java.lang.RuntimeException: Unable to start activity ComponentInfo{com.example.miauto/com.example.miauto.LoginActivity}: java.lang.RuntimeException: Cannot find implementation for com.example.AppDatabase. AppDatabase_Impl does not exist at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3782) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:3922) at android.app.servertransaction.LaunchActivityItem.execute(LaunchActivityItem.java:103) at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:139) at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:96) at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2443) at android.os.Handler.dispatchMessage(Handler.java:106) at android.os.Looper.loopOnce(Looper.java:205) at android.os.Looper.loop(Looper.java:294) at android.app.ActivityThread.main(ActivityThread.java:8177) at java.lang.reflect.Method.invoke(Native Method) at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:552) at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:971) Caused by: java.lang.RuntimeException: Cannot find implementation for com.example.AppDatabase. AppDatabase_Impl does not exist at androidx.room.Room.getGeneratedImplementation(Room.kt:58) at androidx.room.RoomDatabase$Builder.build(RoomDatabase.kt:1351) at com.example.miauto.LoginActivity.onCreate(LoginActivity.kt:56) at android.app.Activity.performCreate(Activity.java:8595) at android.app.Activity.performCreate(Activity.java:8573) at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1456) at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3764) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:3922)  at android.app.servertransaction.LaunchActivityItem.execute(LaunchActivityItem.java:103)  at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:139)  at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:96)  at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2443)  at android.os.Handler.dispatchMessage(Handler.java:106)  at android.os.Looper.loopOnce(Looper.java:205)  at android.os.Looper.loop(Looper.java:294)  at android.app.ActivityThread.main(ActivityThread.java:8177)  at java.lang.reflect.Method.invoke(Native Method)  at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:552)  at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:971) 

问题原因分析 #

• 注解处理器配置错误：Kotlin项目需用kapt处理注解，而不是Java项目的annotationProcessor，否则Room无法生成AppDatabase_Impl实现类。
• 未启用kapt插件：模块级build.gradle.kts未添加kapt插件，导致注解处理器无法工作。
• 未重新构建项目：修改依赖后未清理构建，注解处理器未生成实现类。
• 包名不一致：AppDatabase的包名与代码中引用的包名不匹配，Room找不到对应实现。
• 主线程操作数据库：即使解决Impl问题，当前代码在主线程执行数据库读写，会触发Room主线程检查崩溃。

解决步骤 #

1. 修正Room依赖配置 #

在模块级build.gradle.kts中启用kapt插件，并替换注解处理器依赖：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("kotlin-kapt") // 新增kapt插件
}

val room_version = "2.5.0"

implementation("androidx.room:room-runtime:$room_version")
kapt("androidx.room:room-compiler:$room_version") // 替换annotationProcessor为kapt
implementation("androidx.room:room-ktx:$room_version")

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

• 点击Android Studio工具栏Build -> Clean Project
• 再点击Build -> Rebuild Project

3. 检查包名一致性 #

确保AppDatabase.kt的包名与LoginActivity.kt中引用的AppDatabase::class.java包名完全一致。

4. 修复主线程数据库操作问题 #

Room默认禁止主线程执行数据库操作，推荐用协程处理：

// 先添加协程依赖（若未添加）
// implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")

class LoginActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // ...

        val vehiculos = listOf(
            // ... (车辆列表)
        )

        val db = Room.databaseBuilder(
            applicationContext,
            AppDatabase::class.java, "vehiculos"
        ).build()

        // 用生命周期协程执行数据库操作
        lifecycleScope.launch {
            val vehiculoDao = db.vehiculoDao()

            for (vehiculo in vehiculos) {
                vehiculoDao.InsertarVehiculo(vehiculo)
            }

            val todosLosVehiculos = vehiculoDao.ObtenerVehiculos()

            for (vehiculo in todosLosVehiculos) {
                println("ID: ${vehiculo.id}, Marca: ${vehiculo.marca}, Modelo: ${vehiculo.modelo}, Tipo: ${vehiculo.tipo}")
            }
        }
    }
}

若仅用于临时测试，可允许主线程操作（不推荐生产环境）：

val db = Room.databaseBuilder(
    applicationContext,
    AppDatabase::class.java, "vehiculos"
).allowMainThreadQueries() // 添加此行
.build()

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