Android Studio提示@HiltAndroidApp/@HiltViewModel未引用但编译正常

解决方案 #

1. 检查依赖配置完整性 #

首先核对全链路gradle配置，避免缺项：

• 项目根目录build.gradle插件配置：

plugins {
    id 'com.google.dagger.hilt.android' version '你的Hilt版本号' apply false
    id 'org.jetbrains.kotlin.android' version '你的Kotlin版本号' apply false
}

• 应用模块build.gradle插件配置：

plugins {
    id 'kotlin-kapt'
    id 'com.google.dagger.hilt.android'
}

• 应用模块依赖配置，必须同时引入以下项，不要遗漏：

// Hilt核心依赖
implementation "com.google.dagger:hilt-android:你的Hilt版本号"
kapt "com.google.dagger:hilt-android-compiler:你的Hilt版本号"

// Hilt扩展依赖，缺失会导致@HiltViewModel、@HiltAndroidApp识别异常
implementation "androidx.hilt:hilt-lifecycle-viewmodel:1.0.0-alpha03"
kapt "androidx.hilt:hilt-compiler:1.0.0"

注意：不要将上述依赖配置在debugImplementation、testImplementation等局部变体依赖内，必须放在全局依赖作用域

2. 校验版本兼容性 #

Hilt版本与Kotlin版本存在强绑定关系，版本不匹配会触发IDE识别异常：

• Hilt 2.38.x要求Kotlin版本 >= 1.5.30
• Hilt 2.39.x要求Kotlin版本 >= 1.6.0
  你可以同步升级Kotlin插件与依赖版本到匹配区间，再重新构建项目。

3. 清理全局缓存 #

此前你只清理了项目级缓存，还需要删除全局级缓存修复索引损坏：

• 关闭所有Android Studio项目
• 进入系统Gradle缓存目录：
  • Windows：C:\Users\你的用户名\.gradle\caches
  • Mac/Linux：/Users/你的用户名/.gradle/caches
• 删除该目录下所有包含kotlin、dagger、hilt关键字的文件夹
• 重新打开Android Studio等待索引完成即可

4. 检查IDE注解处理器配置 #

• 打开Settings > Build, Execution, Deployment > Compiler > Annotation Processors
• 确认勾选Enable annotation processing，同时选中Obtain processors from project classpath选项
• 保存后重启IDE

5. 禁用实验性索引（Android Studio Bumblebee及以上版本适用） #

新版AS的实验性索引功能可能存在注解识别异常：

• 打开Help > Edit Custom VM Options
• 新增配置项：-Didea.is.new.indexing.enabled=false
• 保存后重启IDE即可恢复注解识别

内容的提问来源于stack exchange，提问作者Matteo Melis