Gradle构建进程卡顿问题求助及已尝试解决步骤

已尝试的排查步骤 #

• 重启电脑
• 执行 ./gradlew clean build 清理并重新构建
• Android Studio中执行Invalidate Caches/Restart
• 删除fileHashes.lock文件
• 查阅Stack Overflow及Gradle论坛未找到有效方案

额外排查与解决建议 #

1. 调整Gradle核心配置 #

• 优先使用稳定版Gradle，避免使用RC或快照版本，可尝试升级到最新稳定版
• 修改gradle.properties文件，添加或调整性能优化参数：

  # 增大Gradle堆内存分配
  org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m
  # 开启并行构建
  org.gradle.parallel=true
  # 启用构建缓存
  org.gradle.caching=true
  # 开启守护进程
  org.gradle.daemon=true
  

2. 优化依赖与仓库 #

• 替换响应缓慢的依赖仓库为国内镜像源，提升依赖拉取速度
• 执行 ./gradlew dependencies --refresh-dependencies 强制刷新依赖，排查是否存在依赖拉取卡顿
• 用./gradlew dependencyInsight --dependency <依赖名>分析依赖树，清理重复或未使用的冗余依赖

3. 系统资源排查 #

• 查看系统任务管理器/活动监视器，关闭占用大量CPU、内存的后台进程，为Gradle构建预留足够资源
• 检查磁盘状态，若使用机械硬盘建议更换为SSD，同时清理磁盘释放足够空间（避免磁盘IO瓶颈）

4. Android Studio插件与配置优化 #

• 关闭不必要的第三方插件，仅保留核心开发相关插件
• 在File > Settings > Build, Execution, Deployment > Compiler中，勾选Compile independent modules in parallel开启模块并行编译

5. 定位卡顿具体阶段 #

• 执行 ./gradlew build --info 获取详细构建日志，定位卡顿发生的具体任务环节（如依赖下载、编译、打包等）
• 用./gradlew build --profile生成构建性能报告，报告中会展示每个任务的耗时数据，精准定位性能瓶颈

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