You need to enable JavaScript to run this app. Dagger Hilt报错@HiltAndroidApp需赋值且kaptDebugKotlin任务失败如何解决
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 13:15:02