问题：Could not find method kapt() for arguments [com.google.dagger:hilt-android-compiler...]

Question

在使用 Hilt 进行 Android 开发时，开发者可能会遇到如下构建错误：“Could not find method kapt() for arguments [com.google.dagger:hilt-android-compiler...]”。该问题通常出现在 Gradle 配置不正确或未正确应用 Kotlin KAPT 插件的情况下。`kapt` 是 Kotlin 用于支持注解处理器的插件，若未在 `build.gradle.kts` 或 `build.gradle` 文件中启用 `kapt`，则无法识别 `kapt()` 方法，导致构建失败。 常见原因包括：未在模块级 `build.gradle` 中添加 `kotlin-kapt` 插件、Gradle 版本与插件不兼容、或依赖项配置错误。解决方法包括检查并添加 `plugins { id("kotlin-kapt") }`，确认 Hilt 编译器依赖项是否正确引入，并确保使用的 Gradle 和 Kotlin 插件版本兼容最新 Hilt 要求。

Answer 1

一、问题现象：构建错误 “Could not find method kapt()”

在使用 Hilt 进行 Android 应用开发时，开发者常常会遇到如下构建错误：

Could not find method kapt() for arguments [com.google.dagger:hilt-android-compiler...]

该错误提示表明 Gradle 在执行配置时无法识别 `kapt()` 方法。这通常与模块级的 Gradle 配置有关，尤其是与 Kotlin 注解处理器插件（KAPT）是否启用相关。

二、常见原因分析

• 未正确添加 kotlin-kapt 插件：模块级 build.gradle.kts 文件中缺少 `kotlin-kapt` 插件声明。
• Hilt 编译器依赖项配置不正确：未正确引入 Hilt 的注解处理器依赖。
• Gradle 与 Kotlin 插件版本不兼容：项目中使用的 Gradle 版本与 Kotlin 插件版本可能不兼容当前 Hilt 的要求。
• 项目结构或配置文件格式错误：如使用了旧版 Gradle 脚本语法（Groovy）却在 build.gradle.kts 中写入 Groovy 格式内容。

三、解决步骤详解

1. 检查并添加 kotlin-kapt 插件：

   在模块级 build.gradle.kts 文件顶部的 plugins 块中添加以下语句：

   plugins {
       id("kotlin-kapt")
   }

2. 确认 Hilt 依赖和注解处理器配置：

   确保在 dependencies 块中添加了 Hilt 的运行时依赖和编译器依赖：

   dependencies {
       implementation("com.google.dagger:hilt-android:2.48")
       kapt("com.google.dagger:hilt-android-compiler:2.48")
   }

3. 检查 Gradle 和 Kotlin 插件版本兼容性：

   查看官方文档以确认当前使用的 Gradle 和 Kotlin 插件版本是否支持所引用的 Hilt 版本。例如，在项目级 build.gradle.kts 文件中指定合适的 Kotlin 插件版本：

   kotlin("jvm").version("1.9.0").apply(false)

4. 清理并重建项目：

   执行 Gradle 清理任务后重新同步项目：

   ./gradlew clean
   ./gradlew syncProject

四、扩展知识：KAPT 与 KSP 的对比

特性	KAPT	KSP
实现方式	基于 Java APT 模拟	原生 Kotlin 支持
性能	较慢	更快
与 Kotlin 协同性	部分兼容问题	更佳兼容性
适用场景	传统 Java 注解处理兼容项目	现代 Kotlin 项目推荐

五、流程图：问题排查逻辑

graph TD
A[构建失败: Could not find method kapt] --> B{是否启用了kotlin-kapt插件?}
B -- 否 --> C[添加id(\"kotlin-kapt\")到plugins]
B -- 是 --> D{Hilt依赖是否正确配置?}
D -- 否 --> E[添加implementation和kapt依赖]
D -- 是 --> F{Gradle/Kotlin版本是否兼容Hilt?}
F -- 否 --> G[升级/降级Gradle/Kotlin插件版本]
F -- 是 --> H[尝试clean & rebuild项目]
H --> I[问题是否解决?]
I -- 否 --> J[检查IDE缓存或重启Android Studio]
I -- 是 --> K[构建成功]