Android Hilt报错@InstallIn value无效或缺失问题排查

你遇到的编译错误由三个配置问题共同导致：

1. Hilt插件ID不匹配：app模块使用了已废弃的旧版Hilt插件ID，和根目录声明的新版Hilt插件版本不兼容，导致注解处理器无法正确识别@InstallIn的参数，误判为空值
2. Room数据库配置缺失：未指定schema导出规则，注解处理器抛出警告干扰KAPT的stub生成流程，放大了Hilt的注解扫描错误
3. 存在过时的Hilt扩展依赖，和当前Hilt版本冲突

按以下顺序调整配置即可解决问题：

• 修正Hilt插件ID
  打开app模块的build.gradle，找到plugins块，把旧的插件声明：

  id 'dagger.hilt.android.plugin'
  

  替换为和根目录声明一致的新版插件ID：

  id 'com.google.dagger.hilt.android'
  

• 修复Room的schema警告
  打开StockDatabase.kt，如果不需要导出数据库schema做迁移测试，直接在@Database注解中关闭schema导出即可：

  @Database(
      entities = [CompanyListingEntity::class],
      version = 1,
      exportSchema = false
  )
  abstract class StockDatabase:RoomDatabase() {
      abstract val dao:StockDao
  }
  

  如果需要保留schema导出能力，在app模块build.gradle的android.defaultConfig块中添加注解处理器参数：

  javaCompileOptions {
      annotationProcessorOptions {
          arguments += ["room.schemaLocation": "$projectDir/schemas".toString()]
      }
  }
  

• 移除冲突的过时依赖
  在app模块的dependencies块中，删除以下过时的Hilt扩展依赖，当前版本的androidx.hilt:hilt-navigation-compose已经内置了ViewModel注入支持，不需要单独引入这个alpha版本的旧库：

  implementation "androidx.hilt:hilt-lifecycle-viewmodel:1.0.0-alpha03"
  

• 清理构建缓存
  先在Android Studio中执行File -> Invalidate Caches...，勾选所有缓存选项后重启IDE，再在项目根目录执行构建清理命令：
  Windows系统执行：

  gradlew.bat clean
  

  Mac/Linux系统执行：

  ./gradlew clean
  

• 重新构建项目即可正常编译通过。

如果完成以上步骤后仍然报错，全局搜索项目中所有使用@InstallIn注解的位置，确认没有任何地方使用了空参数的@InstallIn()写法，同时确认你的自定义Application类已经添加@HiltAndroidApp注解，并且在AndroidManifest.xml中正确注册。

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