kaptGenerateStubsDebugKotlin编译失败，无法加载模块，求解决方案

错误日志 #

> Task :entities:bundleLibCompileToJarDebug

> Task :app:kaptGenerateStubsDebugKotlin FAILED
e: Could not load module <Error module>

> Task :app:mergeLibDexDebug

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:kaptGenerateStubsDebugKotlin'.
> A failure occurred while executing org.jetbrains.kotlin.compilerRunner.GradleCompilerRunnerWithWorkers$GradleKotlinCompilerWorkAction
   > Compilation error. See log for more details

已尝试操作 #

• 删除.idea目录
• 重启电脑
• 删除所有Gradle缓存
• 重建项目

额外解决建议 #

• 检查kapt依赖兼容性：确认所有注解处理器（如Room、Dagger）的版本与项目Kotlin版本匹配，版本不兼容是这类错误的常见诱因，同步所有相关依赖版本后重新编译。
• 查看完整堆栈日志：执行命令 ./gradlew app:kaptGenerateStubsDebugKotlin --stacktrace（Windows环境用 gradlew.bat 替代），通过完整堆栈信息定位<Error module>对应的具体模块或依赖问题。
• 排查依赖冲突：运行 ./gradlew app:dependencies 生成依赖树，检查entities和app模块间是否存在依赖版本冲突，找到冲突项后通过exclude语法排除重复依赖。
• 清理kapt生成文件：删除app/build/generated/source/kapt和entities/build/generated/source/kapt目录，手动清理kapt生成的缓存文件后重新构建。
• 禁用增量编译：在项目根目录的gradle.properties中添加 kapt.incremental.apt=false，关闭kapt增量编译，避免缓存异常导致的模块加载问题。
• 校验Kotlin与AGP版本匹配：确保项目根build.gradle中Kotlin插件版本和Android Gradle Plugin（AGP）版本兼容，例如AGP 7.x对应Kotlin 1.7.x，AGP 8.x对应Kotlin 1.8.x及以上版本。
• 检查注解语法错误：排查近期新增的注解使用代码（如Room实体类、Dagger组件），确认没有语法错误或不符合注解规范的写法，这类问题会导致kapt无法生成正确的Stub文件，进而引发模块加载失败。

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