Jetpack Compose整合Hilt与Firebase时kapt编译失败问题求助

以下是针对该问题的具体排查和解决步骤：

1. 核对依赖版本兼容性 #

• 确保Hilt版本与Android Gradle Plugin（AGP）版本匹配，例如AGP 7.4+对应Hilt 2.44及以上版本。
• 使用Firebase BOM统一管理Firebase SDK版本，避免组件间版本冲突：

  // 项目级build.gradle.kts
  dependencies {
      implementation(platform("com.google.firebase:firebase-bom:32.7.0"))
      implementation("com.google.firebase:firebase-auth")
  }
  

• 保证Hilt的implementation和kapt依赖版本完全一致：

  // 模块级build.gradle.kts
  implementation("com.google.dagger:hilt-android:2.48")
  kapt("com.google.dagger:hilt-android-compiler:2.48")
  

2. 检查FirebaseModule的注解与实现 #

• 必须给Module类添加@Module和@InstallIn(SingletonComponent::class)注解，确保依赖注入的作用域正确：

  @Module
  @InstallIn(SingletonComponent::class)
  object FirebaseModule {
      @Provides
      @Singleton
      fun provideFirebaseAuth(): FirebaseAuth {
          return FirebaseAuth.getInstance()
      }
  }
  

• 确认你的Application类添加了@HiltAndroidApp注解，这是Hilt初始化的核心：

  @HiltAndroidApp
  class MyApp : Application()
  

3. 验证Repository与ViewModel的注入逻辑 #

• Repository需通过构造函数注入Firebase依赖，确保使用@Inject注解：

  class FirebaseAuthRepository @Inject constructor(
      private val firebaseAuth: FirebaseAuth
  ) {
      // 业务逻辑实现
  }
  

• ViewModel必须添加@HiltViewModel注解，且构造函数使用@Inject：

  @HiltViewModel
  class LoginViewModel @Inject constructor(
      private val authRepo: FirebaseAuthRepository
  ) : ViewModel() {
      // ViewModel逻辑
  }
  

• 在Compose界面中使用hiltViewModel()获取ViewModel实例，禁止手动new对象。

4. 修复kapt配置问题 #

• 模块级build.gradle.kts中必须启用kotlin-kapt和dagger.hilt.android.plugin插件：

  plugins {
      id("com.android.application")
      id("kotlin-android")
      id("kotlin-kapt")
      id("dagger.hilt.android.plugin")
  }
  

5. 清理构建缓存 #

• 执行Gradle清理命令：

  ./gradlew clean
  

• 重新构建项目：

  ./gradlew assembleDebug
  

• 若仍有问题，在Android Studio中执行File -> Invalidate Caches... -> Invalidate and Restart清除IDE缓存。

6. 定位真正的异常原因 #

InvocationTargetException只是包装了底层错误，需查看完整堆栈信息：

• 在终端执行命令获取详细日志：

  ./gradlew kaptDebugKotlin --stacktrace
  

• 找到日志中Caused by:开头的内容，这才是导致kapt失败的具体原因（比如注解缺失、依赖未注入、代码语法错误等）。

7. 多模块与混淆相关排查 #

• 多模块项目中，library模块需引入hilt-android依赖，且Module的@InstallIn要选择合适的Component（如ActivityComponent::class）。
• 若开启混淆，需在proguard-rules.pro中添加Hilt相关规则：

  -keep class dagger.hilt.** { *; }
  -keep @dagger.hilt.android.HiltAndroidApp class *
  -keep class * extends dagger.hilt.android.HiltAndroidApp
  

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