重装Android Studio后构建项目报kaptDebugKotlin执行失败错误

该错误属于Kotlin注解处理阶段的通用包装错误，外层抛出的java.lang.reflect.InvocationTargetException不会携带真实错误信息，重装IDE后触发的场景下，常见根因如下：

• 构建缓存损坏/不兼容
  重装IDE后本地留存的旧版本Gradle构建缓存、kapt生成代码缓存、IDE项目配置缓存，和新装IDE的插件版本、构建工具版本存在兼容冲突，注解处理器读取过期缓存文件时直接触发底层崩溃，不会打印上层业务错误。可先执行./gradlew clean清理构建产物，再删除项目根目录下的.gradle、.idea文件夹及app/build目录，重新同步Gradle后再尝试构建。
• JDK版本不匹配
  重装Android Studio后Gradle依赖的JDK版本会被重置为IDE默认值，如果默认JDK版本和项目要求的版本不一致（比如项目适配JDK11但IDE默认选中JDK17，或使用了过低版本的JDK），kapt运行注解处理器时的反射调用逻辑会触发版本兼容问题，仅抛出包装类异常。可在Settings > Build, Execution, Deployment > Build Tools > Gradle路径下检查Gradle JDK配置，优先选择IDE内嵌的JetBrains Runtime（JBR）减少兼容问题。
• Kotlin版本与注解处理器版本不兼容
  重装Android Studio时如果连带更新了内置的Kotlin插件，且构建时触发了Kotlin版本自动升级，但项目中依赖的Room、Dagger/Hilt、DataBinding、Moshi等依赖kapt的注解处理器版本没有同步适配，注解处理阶段调用不匹配的API时会直接触发KaptBaseError。可执行./gradlew :app:kaptDebugKotlin --info --stacktrace查看info级别的完整日志，被包装异常包裹的真实栈轨迹会明确标注出错的注解处理器及具体兼容问题。
• Gradle与KGP版本错位
  重装IDE后如果触发了Gradle版本自动升级，但是项目中声明的kotlin-gradle-plugin（KGP）版本、kapt插件版本没有和Gradle版本做对应匹配（比如Gradle 8.x搭配1.6.x及以下版本的Kotlin插件），会导致kapt任务内部运行逻辑直接报错。

注意：控制台默认输出的错误信息是反射调用的外层包装错误，不要仅靠外层报错定位问题，加--info或--debug参数运行构建才能拿到真实的错误栈，加--scan参数可以直接可视化查看kapt阶段的所有异常详情。

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