构建时遇Task :app:kaptGenerateStubsDebugKotlin失败及模块加载问题求助

1. 清理并重建项目 #

• 执行Android Studio操作：Build > Clean Project，随后Build > Rebuild Project
• 或使用命令行：

  ./gradlew clean
  ./gradlew assembleDebug
  

2. 校验Kotlin与kapt版本兼容性 #

打开项目根目录的build.gradle（项目级），确保Kotlin插件版本与Gradle版本匹配，且kapt依赖版本与Kotlin版本完全一致：

buildscript {
    ext.kotlin_version = "1.8.22" // 保证此版本与app模块中kapt依赖版本对应
    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

3. 检查注解处理器配置（以Room为例） #

项目中使用了Room，需确认app/build.gradle里的Room依赖配置正确，注解处理器版本与Runtime版本一致：

def room_version = "2.5.0"

implementation "androidx.room:room-runtime:$room_version"
kapt "androidx.room:room-compiler:$room_version"
// 若尝试切换到KSP（Kotlin Symbol Processing），可替换kapt为：
// ksp "androidx.room:room-compiler:$room_version"

切换到KSP有时能解决模块加载类的问题。

4. 排查模块依赖与导入问题 #

• 检查所有代码中的import语句，确认没有引用不存在的类或模块，排除拼写错误、依赖模块未正确引入的情况
• 打开settings.gradle，确认所有需要的模块都已正确包含，无路径错误或遗漏

5. 清除Gradle缓存 #

• 删除项目根目录下的.gradle文件夹
• 删除用户目录中的Gradle缓存：macOS/Linux路径为~/.gradle/caches，Windows路径为C:\Users\<你的用户名>\.gradle\caches
• 重新同步项目：File > Sync Project with Gradle Files

6. 更新Kotlin插件 #

打开Android Studio的Settings > Plugins > Marketplace，搜索Kotlin插件并更新至最新稳定版，随后重启IDE。

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