使用Hilt注入Room数据库时遇MovieDatabase_Impl不存在异常求助

异常信息 #

Caused by: java.lang.RuntimeException: cannot find implementation for com.qst.qstmoviesapp.db.MovieDatabase. MovieDatabase_Impl does not exist
at androidx.room.Room.getGeneratedImplementation(Room.java:100)
at androidx.room.RoomDatabase$Builder.build(RoomDatabase.java:1486)
at com.qst.qstmoviesapp.di.DatabaseModule.provideDatabase(DatabaseModule.kt:28)
atcom.qst.qstmoviesapp.di.DatabaseModule_ProvideDatabaseFactory.provideDatabase(DatabaseModule_ProvideDatabaseFactory.java:37)
at com.qst.qstmoviesapp.DaggerMovieApp_HiltComponents_SingletonC$SingletonCImpl$SwitchingProvider.get(DaggerMovieApp_HiltComponents_SingletonC.java:656)
at dagger.internal.DoubleCheck.get(DoubleCheck.java:47)                                                                                                    
at
com.qst.qstmoviesapp.DaggerMovieApp_HiltComponents_SingletonC$SingletonCImpl.movieDao(DaggerMovieApp_HiltComponents_SingletonC.java:610)
atcom.qst.qstmoviesapp.DaggerMovieApp_HiltComponents_SingletonC$SingletonCImpl.access$1700(DaggerMovieApp_HiltComponents_SingletonC.java:594)
at com.qst.qstmoviesapp.DaggerMovieApp_HiltComponents_SingletonC$SingletonCImpl$SwitchingProvider.get(DaggerMovieApp_HiltComponents_SingletonC.java:653)                                                                                                        at
dagger.internal.DoubleCheck.get(DoubleCheck.java:47)                                                                                                        atcom.qst.qstmoviesapp.DaggerMovieApp_HiltComponents_SingletonC$ViewModelCImpl$SwitchingProvider.get(DaggerMovieApp_HiltComponents_SingletonC.java:518)                                                                                                     at dagger.hilt.android.internal.lifecycle.HiltViewModelFactory$1.create(HiltViewModelFactory.java:104)
at androidx.lifecycle.AbstractSavedStateViewModelFactory.create(AbstractSavedStateViewModelFactory.java:89)
at dagger.hilt.android.internal.lifecycle.HiltViewModelFactory.create(HiltViewModelFactory.java:116)
at androidx.lifecycle.ViewModelProvider.get(ViewModelProvider.kt:187)
at androidx.lifecycle.ViewModelProvider.get(ViewModelProvider.kt:153)
at androidx.lifecycle.ViewModelLazy.getValue(ViewModelLazy.kt:53)
at androidx.lifecycle.ViewModelLazy.getValue(ViewModelLazy.kt:35)
at com.qst.qstmoviesapp.ui.MovieFragment.getMovieViewModel(MovieFragment.kt:30)

核心问题及解决方案 #

1. Room注解处理器配置错误（最可能原因） #

项目使用Kotlin开发，但Room的注解处理器用了Java项目的annotationProcessor，Kotlin项目必须替换为kapt：

修改app/build.gradle中的Room依赖：

// 替换原有的annotationProcessor配置
kapt("androidx.room:room-compiler:2.4.3")
// 可选：添加Room Kotlin扩展支持
implementation("androidx.room:room-ktx:2.4.3")

同时确保gradle文件顶部启用kapt插件：

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'kotlin-kapt' // 必须添加此插件
    id 'dagger.hilt.android.plugin'
}

2. 检查Hilt全局初始化 #

确认Application类添加了@HiltAndroidApp注解，这是Hilt启动的必要条件：

@HiltAndroidApp
class MovieApp : Application() {
    // ...
}

3. 清理编译缓存并重建 #

缓存异常可能导致生成类缺失，执行以下操作：

• 点击Android Studio菜单栏Build -> Clean Project
• 再执行Build -> Rebuild Project
• 或直接删除项目根目录的build和.gradle文件夹后重新同步项目

4. 验证Room实体类配置 #

确保Movie实体类正确添加@Entity注解并定义主键：

@Entity(tableName = "movies")
data class Movie(
    @PrimaryKey val id: Int,
    // 其他字段...
)

5. 检查Database类注解格式 #

确认MovieDatabase的@Database注解正确引用实体类，Kotlin中可简化写法：

@Database(entities = [Movie::class], version = 1, exportSchema = false)
abstract class MovieDatabase : RoomDatabase() {
    abstract fun movieDao(): MovieDao
}

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