Android Studio构建时报':app:kaptDebugKotlin'任务执行失败错误

任务':app:kaptDebugKotlin'执行失败，具体错误详情为执行org.jetbrains.kotlin.gradle.internal.KaptWithoutKotlincTask$KaptExecutionWorkAction时发生故障，抛出java.lang.reflect.InvocationTargetException异常

1. 先获取完整错误日志 #

该报错属于Kapt执行时的上层封装异常，默认不会输出具体根因，首先需要开启详细日志定位问题：

• 在项目根目录的gradle.properties文件中添加以下配置：

  kapt.verbose=true
  org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
  

• 命令行执行构建时添加参数输出完整堆栈：

  ./gradlew assembleDebug -s
  

重新构建后即可看到具体触发异常的代码或依赖信息。

2. 常见问题排查 #

拿到具体日志前，可以先按以下高频场景逐一验证：

• Kotlin版本全局对齐：检查项目级build.gradle中的Kotlin插件版本、模块级build.gradle中的kotlin-stdlib依赖版本、所有kapt声明的Kotlin相关依赖版本必须完全一致，跨版本调用是该类报错的最常见诱因
• 注解处理器版本匹配：Room、Dagger/Hilt、DataBinding等需要注解处理器的库，必须保证implementation依赖和对应kapt依赖的版本完全相同，比如Room的runtime版本和room-compiler版本必须一致
• 缓存冲突清理：依次执行以下操作清理所有构建缓存后重试：
  1. 执行命令：./gradlew clean && ./gradlew --stop
  2. 删除项目根目录下的.gradle文件夹、app模块下的build文件夹
  3. 重启Android Studio后重新执行构建
• JDK版本兼容校验：Kotlin 1.7及以上版本要求配套JDK 11及以上，检查Gradle使用的JDK版本路径：File > Settings > Build, Execution, Deployment > Build Tools > Gradle > Gradle JDK，选择官方推荐的适配版本即可
• DataBinding配置校验：如果开启了DataBinding，确保模块级build.gradle中同时声明了DataBinding开启配置和对应版本的kapt "com.android.databinding:compiler"依赖

3. 极端场景处理 #

如果以上步骤均无法解决问题，可尝试以下方案：

• 将kapt替换为KSP（Kotlin符号处理工具），当前主流注解框架均已支持KSP，相比kapt报错信息更清晰，构建速度也更快
• 回退最近的代码、依赖配置变更，逐一验证是哪一次修改触发的构建异常

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