Android项目集成Dagger Hilt时Kapt任务执行失败求助

问题概述 #

构建集成Dagger Hilt、Glide（暂注释）与Kapt的Android应用时，出现两个核心错误：

1. 无法解析com.android.tools.build:gradle:8.1.2，提示Java版本兼容问题
2. 执行org.jetbrains.kotlin.gradle.internal.KaptWithoutKotlincTask$KaptExecutionWorkAction失败，伴随java.lang.reflect.InvocationTargetException

终端错误信息（翻译后） #

无法解析配置':classpath'的所有文件。
无法解析com.android.tools.build:gradle:8.1.2。
被以下项目依赖：
project : > com.android.application:com.android.application.gradle.plugin:8.1.2
project : > com.android.library:com.android.library.gradle.plugin:8.1.2

未找到com.android.tools.build:gradle:8.1.2的匹配变体。消费者配置为查找一个运行时使用的库，兼容Java 8，打包为jar，依赖项外部声明，以及属性'org.gradle.plugin.api-version'值为'8.0'，但：

• 变体'apiElements'的能力com.android.tools.build:gradle:8.1.2声明了一个库，打包为jar，依赖项外部声明：
• 不兼容，因为该组件声明为编译时使用，兼容Java 11，而消费者需要运行时使用、兼容Java 8的组件
• 其他兼容属性：
• 未提及org.gradle.plugin.api-version（要求值为'8.0'）
• 变体'javadocElements'的能力com.android.tools.build:gradle:8.1.2声明了一个运行时使用的组件，依赖项外部声明：
• 不兼容，因为该组件声明为文档，而消费者需要库
• 其他兼容属性：
• 未提及目标Java版本（要求兼容Java 8）
• 未提及元素打包方式（要求打包为jar）
• 未提及org.gradle.plugin.api-version（要求值为'8.0'）
• 变体'runtimeElements'的能力com.android.tools.build:gradle:8.1.2声明了一个运行时使用的库，打包为jar，依赖项外部声明：
• 不兼容，因为该组件声明兼容Java 11，而消费者需要兼容Java 8的组件
• 其他兼容属性：
• 未提及org.gradle.plugin.api-version（要求值为'8.0'）
• 变体'sourcesElements'的能力com.android.tools.build:gradle:8.1.2声明了一个运行时使用的组件，依赖项外部声明：
• 不兼容，因为该组件声明为文档，而消费者需要库
• 其他兼容属性：
• 未提及目标Java版本（要求兼容Java 8）
• 未提及元素打包方式（要求打包为jar）
• 未提及org.gradle.plugin.api-version（要求值为'8.0'）

解决方案 #

一、修复Gradle 8.1.2的Java版本兼容问题 #

Gradle 8.0+要求Gradle构建自身必须使用Java 11或更高版本，仅修改项目编译版本不足以解决问题，需调整以下配置：

1. 指定Gradle使用的JDK版本
   在项目根目录的gradle.properties文件中添加（若文件不存在则创建）：

org.gradle.java.home=/path/to/your/jdk17

替换为本地JDK17的实际路径，例如：

• Windows：C:\Program Files\Java\jdk-17.0.9
• Mac：/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home

2. 匹配Gradle插件与Gradle版本
   Gradle Plugin 8.1.2需要搭配Gradle 8.0+，修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

distributionUrl=https\://services.gradle.org/distributions/gradle-8.1.1-all.zip

3. 修正根build.gradle的仓库配置
   Android Gradle插件需从Google仓库获取，更新buildscript块：

buildscript {
    ext.kotlin_version = '1.9.0'
    repositories {
        google() // 添加Google仓库
        mavenCentral()
    }
    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

二、解决Kapt的InvocationTargetException错误 #

该错误通常由注解处理器配置或依赖冲突导致，完成上述Gradle修复后，执行以下操作：

1. 验证Hilt基础配置
   确保Application类添加了@HiltAndroidApp注解：

@HiltAndroidApp
class MyApplication : Application() {
    // 自定义逻辑
}

2. 清理构建缓存并重新构建
   执行命令清除旧缓存，避免缓存干扰：

./gradlew clean
./gradlew assembleDebug

3. 移除冲突依赖
   旧版本的lifecycle-extensions:2.2.0与新版Lifecycle组件存在冲突，移除该依赖：

// 删除此行
// implementation 'androidx.lifecycle:lifecycle-extensions:2.2.0'

4. 启用Kapt详细日志定位问题
   若仍无法解决，在gradle.properties中添加日志配置，查看具体错误：

kapt.debug=true

重新构建后，从日志中定位注解处理器的具体报错点。

内容的提问来源于stack exchange，提问作者m.karman