Jetpack Compose项目集成Dagger Hilt遇类找不到异常求助

可能原因及对应解决方法 #

1. 依赖版本兼容性问题

• 确保Hilt版本与Compose、AGP（Android Gradle Plugin）版本匹配：
  • AGP 8.x需搭配Hilt 2.48及以上版本；
  • 优先使用KSP替代KAPT处理Hilt注解（AGP 7.0+推荐），避免版本不兼容导致的注解处理失败。

2. 自定义Application类配置错误

• 确认SaltaConejoApplication类正确添加@HiltAndroidApp注解，无拼写错误：

  @HiltAndroidApp
  class SaltaConejoApplication : Application() {
      // 业务代码
  }
  

• 检查AndroidManifest.xml中Application类的全路径是否正确，包名、类名大小写需完全匹配：

  <application
      android:name=".SaltaConejoApplication"
      <!-- 其他配置项 -->
      >
  </application>
  

3. Gradle配置遗漏或错误

• 根目录build.gradle需添加Hilt插件classpath：

  buildscript {
      dependencies {
          classpath "com.google.dagger:hilt-android-gradle-plugin:2.48"
      }
  }
  

• 模块级build.gradle需正确应用插件并配置依赖：
  若使用KSP：

  plugins {
      id 'com.android.application'
      id 'kotlin-android'
      id 'dagger.hilt.android.plugin'
      id 'com.google.devtools.ksp'
  }
  
  dependencies {
      implementation "com.google.dagger:hilt-android:2.48"
      ksp "com.google.dagger:hilt-android-compiler:2.48"
      // Compose相关依赖
  }
  

  若使用KAPT：

  plugins {
      id 'com.android.application'
      id 'kotlin-android'
      id 'dagger.hilt.android.plugin'
      id 'kotlin-kapt'
  }
  
  dependencies {
      implementation "com.google.dagger:hilt-android:2.48"
      kapt "com.google.dagger:hilt-android-compiler:2.48"
      // Compose相关依赖
  }
  

  注意：不要同时混用KSP和KAPT，避免注解处理冲突。

4. 构建缓存或编译错误

• 执行./gradlew clean清理构建缓存，再重新编译运行项目；
• 查看Build窗口的编译日志，确认是否存在Hilt注解处理阶段的隐性错误（这类错误会直接导致代理类Hilt_SaltaConejoApplication无法生成）。

5. MainActivity配置问题

• 确保MainActivity添加@AndroidEntryPoint注解，且继承ComponentActivity（Compose项目标准父类）：

  @AndroidEntryPoint
  class MainActivity : ComponentActivity() {
      override fun onCreate(savedInstanceState: Bundle?) {
          super.onCreate(savedInstanceState)
          setContent {
              // Compose UI代码
          }
      }
  }
  

6. 混淆规则遗漏

• 若开启R8/ProGuard，需添加Hilt相关混淆规则：

  -keep class dagger.hilt.** { *; }
  -keep class javax.inject.** { *; }
  -keep class com.yourpackage.SaltaConejoApplication { *; }
  -keep class com.yourpackage.Hilt_SaltaConejoApplication { *; }
  

  或直接引入Hilt官方提供的默认混淆依赖：

  implementation "com.google.dagger:hilt-android-proguard:2.48"
  

7. 对比官方Codelab配置

• 将自己项目的Gradle配置、注解使用逻辑与官方Compose+Hilt Codelab逐行对比，排查版本、插件顺序、注解位置等差异点。

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