Android Kotlin中Dagger Hilt报错：DefaultActivityViewModelFactory无法解析

核心问题分析 #

报错提示ComponentProcessingStep无法处理Singleton组件，根源是找不到dagger.hilt.android.internal.lifecycle.DefaultActivityViewModelFactory，这个类属于Hilt核心依赖，出现此问题通常是依赖版本不兼容、缺失关键依赖、或构建缓存异常导致。

具体解决步骤 #

1. 统一Hilt相关依赖版本 #

Hilt的核心库、编译器、Gradle插件三者版本必须完全一致，否则会出现内部类不匹配的问题。

• 打开项目根目录下的gradle/libs.versions.toml文件，确保以下版本统一：

  [versions]
  hilt = "2.48" # 或最新稳定版
  androidx-hilt = "1.1.0"
  
  [libraries]
  google-hilt-android = { group = "com.google.dagger", name = "hilt-android", version.ref = "hilt" }
  hilt-compiler = { group = "com.google.dagger", name = "hilt-compiler", version.ref = "hilt" }
  hilt-android-gradle-plugin = { group = "com.google.dagger", name = "hilt-android-gradle-plugin", version.ref = "hilt" }
  androidx-hilt-lifecycle-viewmodel = { group = "androidx.hilt", name = "hilt-lifecycle-viewmodel", version.ref = "androidx-hilt" }
  androidx-hilt-compiler = { group = "androidx.hilt", name = "hilt-compiler", version.ref = "androidx-hilt" }
  

2. 补充缺失的AndroidX Hilt编译器依赖 #

使用AndroidX Hilt的ViewModel功能时，除了核心Hilt编译器，还需要添加AndroidX Hilt的编译器：
在App级build.gradle.kts的dependencies块中添加：

kapt(libs.androidx.hilt.compiler)

3. 清理构建缓存并重新编译 #

Android Studio的旧缓存可能导致类加载异常，执行以下操作：

• 点击顶部菜单栏 Build > Clean Project
• 然后点击 Build > Rebuild Project
• 或使用命令行执行：./gradlew clean build

4. 验证Application配置 #

确认AndroidManifest.xml中已正确配置标注了@HiltAndroidApp的Application类：

<application
    android:name=".BaseApp"
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/Theme.DaggerHilt">
    <!-- 其他组件配置 -->
</application>

额外检查点 #

• 确保App级build.gradle.kts中的kapt配置开启了correctErrorTypes：

  kapt {
      correctErrorTypes = true
  }
  

• 确认项目级build.gradle.kts的buildscript中已添加Hilt插件依赖：

  buildscript {
      dependencies {
          classpath(libs.hilt.android.gradle.plugin)
      }
  }
  

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