运行Android项目时Gradle构建失败，删除.gradle文件夹仍未解决

错误详情 #

Running Gradle task 'assembleDebug'...
FAILURE: Build failed with an exception.
BUILD FAILED in 4s
Exception: Gradle task assembleDebug failed with exit code 1

错误位置 #

• 构建文件 E:\ecommerce\android\build.gradle 第28行

核心错误原因 #

• 评估根项目 android 时触发异常，具体链路：

配置项目 :app 时发生问题。
通知项目评估监听器失败。

com.android.build.api.variant.SourceDirectories$Flat com.android.build.api.variant.Sources.getByName(java.lang.String)

Gradle官方排查建议 #

使用 --stacktrace 参数获取完整堆栈跟踪
使用 --info 或 --debug 参数获取更详细的日志输出
使用 --scan 参数获取构建全链路洞察

已执行但无效的操作 #

• 删除项目目录下的 .gradle 文件夹

针对性解决建议 #

1. 校验Gradle与AGP版本兼容性
   该错误多因Android Gradle Plugin(AGP)与Gradle版本不匹配，导致API调用冲突。打开根目录build.gradle（第28行所在文件），核对dependencies块内的AGP版本，对照官方版本映射表调整：
   • AGP 7.x 对应 Gradle 7.x；AGP 8.x 对应 Gradle 8.x
2. 修正自定义源目录配置代码
   检查:app模块build.gradle中是否存在手动调用Sources.getByName的逻辑，AGP新版本中该API已被废弃，需替换为兼容写法，例如：

   // 旧写法（可能报错）
   sources.getByName("main")
   // 新写法
   sources.named("main") {
       srcDirs += file("src/customDir")
   }
   

3. 彻底清理并刷新依赖
   执行以下命令完成深度清理与依赖同步：

   ./gradlew clean
   ./gradlew assembleDebug --refresh-dependencies
   

4. 更新第三方Gradle插件
   项目中使用的第三方插件（如Hilt、Navigation等）可能与当前AGP版本不兼容，需将插件版本升级至官方标注的兼容版本

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