React Native项目升级Gradle 8.10后执行clean卡在0%

问题描述 #

已将Android API版本更新至35，并修改gradlew-wrapper.properties文件中的Gradle版本配置：

distributionUrl=https\://services.gradle.org/distributions/gradle-8.10-all.zip

完成Gradle 8.10安装后，执行gradlew clean命令时，进程卡在初始化阶段0%，处于「Evaluating settings」状态，耗时超12分钟。更换其他Gradle版本后问题依旧。

排查与解决步骤 #

• 检查网络与仓库配置
  Gradle初始化时需要拉取依赖或插件，若网络受限或仓库地址无效会卡住。可以检查settings.gradle（或settings.gradle.kts）中的仓库配置，替换为稳定的国内镜像，同时确认代理设置是否正确（若使用代理）。
• 清理Gradle本地缓存
  删除本地Gradle缓存目录，让Gradle重新下载依赖：
  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • macOS/Linux：~/.gradle/caches
    清理后重新执行gradlew clean。
• 检查settings文件逻辑
  查看settings.gradle（或.kts）中是否存在耗时自定义逻辑、多模块配置错误、无效仓库引用等问题。可以暂时注释非必要的插件或仓库配置，逐步排查定位。
• 禁用Gradle守护进程
  执行命令时添加参数禁用守护，避免守护进程异常导致的卡住：

  ./gradlew clean --no-daemon
  

• 检查系统资源占用
  确认当前系统CPU、内存是否被其他进程占用过高，关闭不必要的后台进程后重试Gradle命令。

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