gradle卡在“starting daemon”本质是本地守护进程启动失败，主因包括jvm参数冲突、gradle.properties错误配置、ide占用锁文件或临时目录权限异常；应先执行gradle --stop并清理daemon目录锁文件，再通过--no-daemon验证，最后调整gradle.properties中的org.gradle.jvmargs参数。
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 任务。
