Dagger Hilt报错@HiltAndroidApp需赋值且kaptDebugKotlin任务失败如何解决
Dagger Hilt两类报错排查解决指南
第一类:@HiltAndroidApp缺少值/未应用Gradle插件报错
按以下顺序排查配置:
- 检查项目根目录
build.gradle的依赖块,确认已添加Hilt插件依赖,版本号和后续依赖保持一致:classpath "com.google.dagger:hilt-android-gradle-plugin:你的Hilt版本号" - 检查app模块
build.gradle头部,确认已应用kapt和Hilt插件:plugins { id 'com.android.application' id 'org.jetbrains.kotlin.android' // 必须添加下面两个插件 id 'kotlin-kapt' id 'dagger.hilt.android.plugin' } - 检查app模块
build.gradle的依赖块,确认已添加完整Hilt依赖,三个位置的Hilt版本完全对齐:implementation "com.google.dagger:hilt-android:你的Hilt版本号"kapt "com.google.dagger:hilt-android-compiler:你的Hilt版本号" - 配置确认无误后,执行
Build -> Clean Project清理构建缓存,再执行File -> Invalidate Caches -> Invalidate and Restart重启Android Studio后重新构建。
第二类:kaptDebugKotlin执行失败InvocationTargetException报错
该报错是注解处理阶段异常的通用提示,优先排查Hilt使用规范问题:
- 检查所有使用Hilt注入的Android组件,必须加对应注解:Activity/Fragment/Service加
@AndroidEntryPoint,ViewModel加@HiltViewModel,禁止不加组件注解直接使用@Inject声明依赖。 - 检查需要Hilt注入的普通类,构造函数必须加
@Inject注解,或者在自定义Module中用@Provides声明实例提供方式。 - 检查自定义Hilt Module,必须同时加
@Module和@InstallIn注解,@InstallIn必须指定作用域,比如@InstallIn(SingletonComponent::class),禁止漏写作用域。 - 排查依赖循环:如果A类依赖B类,B类同时依赖A类会触发kapt无提示崩溃,梳理依赖链解除循环即可。
- 检查版本兼容性:如果Kotlin版本和Hilt版本不匹配也会触发该问题,优先将Hilt升级到最新稳定版,保持和Kotlin版本的兼容关系。
- 开启详细错误日志:在app模块
build.gradle的android块中添加以下配置,重新构建会输出具体报错位置:kapt { correctErrorTypes = true javacOptions { option("-Xmaxerrs", 1000) } }
内容的提问来源于stack exchange,提问作者beast2961
相关产品推荐
相关产品推荐

