Gradle卡住怎么解决？修改gradle-wrapper方法

Gradle卡在“Starting Daemon”并非网络或下载问题，而是本地守护进程启动失败，根源常在于JVM参数冲突、gradle.properties错误配置、IDE残留锁文件或临时目录权限异常；本文直击要害，教你先用`gradle --stop`和清理daemon锁文件快速排障，再通过`--no-daemon`验证、禁用Daemon定位问题，最后精准调整`gradle.properties`中的`org.gradle.jvmargs`（而非误改wrapper配置）来稳定启动——尤其提醒低配环境、Docker及CI场景下的内存设置陷阱、IDE与终端冲突规避，以及多模块中JavaExec任务的隐性卡死风险，帮你彻底告别无响应等待。

Gradle卡在“Starting Daemon”到底卡在哪

根本不是网络或下载问题，而是本地 Gradle 守护进程（Daemon）启动失败或被阻塞。常见现象是命令行停在 Starting Daemon... 一行不动，持续几十秒甚至几分钟，gradle --version 也卡住——说明连最基础的 Daemon 初始化都失败了。

典型诱因：JVM 参数冲突、gradle.properties 里错误配置、IDE（如 IntelliJ）后台占用了端口或锁文件、或系统临时目录权限异常。

• 先试 gradle --stop 强制终止所有守护进程，再运行 gradle tasks --no-daemon 看是否能绕过 Daemon 正常执行——如果可以，基本锁定是 Daemon 自身问题
• 检查 ~/.gradle/daemon/（Linux/macOS）或 %USERPROFILE%\.gradle\daemon\（Windows）下是否有残留的锁文件（如 registry.bin.lock），手动删掉（确保没 gradle 进程在跑）
• 临时禁用 Daemon：在项目根目录加 gradle.properties，写入 org.gradle.daemon=false，验证是否真由 Daemon 导致

修改 gradle-wrapper 配置的正确姿势

改 gradle/wrapper/gradle-wrapper.properties 只解决“下载哪版 Gradle”，不解决“启动卡住”。但很多人误以为升级 wrapper 就能破局——其实如果当前版本本身没问题，盲目升级反而引入兼容性风险（比如旧项目用 Groovy DSL，新 Gradle 版本已默认要求 Kotlin DSL）。

真正该改的，是这个文件里的 distributionUrl 和 JVM 相关参数。

• 确认 URL 协议用 https 而非 http（否则某些企业网络会拦截重定向导致卡住）
• URL 中的 Gradle 版本号必须与项目 build.gradle 兼容；查官方 兼容矩阵，比如 Android Gradle Plugin 8.2 要求 Gradle 8.2+，但不能用 8.4（尚未正式支持）
• 不要手动改 gradle-wrapper.jar 文件——它由 gradlew 脚本自动调用，改了也没用；重点是 gradle-wrapper.properties 和 JVM 启动参数

真正起效的 JVM 参数调整位置

卡在 Starting Daemon，90% 是 JVM 启动时内存或 GC 参数不合理，尤其在低配机器或 Docker 环境中。这些参数**不能**写在 gradle-wrapper.properties，而必须放在 gradle.properties（用户级或项目级）。

gradle-wrapper.properties 只管下载；gradle.properties 才控制 JVM 行为。

• 在项目根目录新建或编辑 gradle.properties，添加：
  

  org.gradle.jvmargs=-Xmx512m -XX:MaxMetaspaceSize=256m -XX:+HeapDumpOnOutOfMemoryError

• 避免设过高内存（如 -Xmx4g）：Docker 容器或 CI 环境可能没这么多堆可用，反而触发 GC 卡死
• Windows 上若用 PowerShell 运行 ./gradlew，注意 gradle.properties 中的反斜杠路径要写成正斜杠或双反斜杠，否则 JVM 参数解析失败静默忽略

IDE 和命令行混用导致的隐藏冲突

IntelliJ 或 Android Studio 默认启用 “Use Gradle from wrapper” 并开启 “Run build using Gradle daemon”，但 IDE 启动的 Daemon 实例和终端里手动跑的 ./gradlew 共享同一套配置和锁文件——一旦 IDE 崩溃未清理 Daemon，终端就永远卡在 Starting。

• 关闭 IDE，杀光 java 进程（pkill -f "GradleDaemon" 或任务管理器结束 java.exe），再清空 ~/.gradle/daemon/
• 在 IDE 的 Settings > Build > Build Tools > Gradle 中，把 Gradle JVM 改为项目指定 JDK（而非默认 bundled JDK），避免 JVM 版本错乱
• CI 环境（如 GitHub Actions）务必加 cache: gradle 并显式设置 GRADLE_USER_HOME，否则每次都是全新 Daemon 初始化，极易超时

最麻烦的其实是多模块项目里某个子模块的 build.gradle 里写了自定义 JavaExec 任务，又没设 fork = true，结果把整个 Daemon 进程卡死——这种得逐个模块排查 JavaExec 和 Exec 任务。

理论要掌握，实操不能落！以上关于《Gradle卡住怎么解决？修改gradle-wrapper方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！