Android Studio中Gradle无法下载依赖问题排查求助

常见原因及解决步骤 #

• 替换Gradle镜像源：默认仓库为国外源，即使VPN/DNS生效也可能无法正常下载。修改项目android/build.gradle文件，替换为国内镜像：

  buildscript {
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/jcenter' }
          maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }
      }
  }
  allprojects {
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/jcenter' }
          maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }
      }
  }
  

• 清理Gradle缓存：缓存损坏会导致依赖校验失败，执行以下命令清理：

  # 清理全局Gradle缓存
  rm -rf ~/.gradle/caches
  # 清理项目内Gradle缓存
  cd android && ./gradlew cleanBuildCache
  

• 调整Gradle版本与下载源：项目指定的Gradle版本可能存在适配问题，修改android/gradle/wrapper/gradle-wrapper.properties：

  # 替换为国内镜像的稳定版Gradle
  distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-7.5-all.zip
  

• 移除冲突的代理配置：VPN可能残留系统代理，导致Gradle连接异常。检查~/.gradle/gradle.properties，删除或注释代理相关行：

  # systemProp.http.proxyHost=xxx
  # systemProp.http.proxyPort=xxx
  # systemProp.https.proxyHost=xxx
  # systemProp.https.proxyPort=xxx
  

• 终端手动指定代理：部分VPN仅代理浏览器流量，未覆盖终端进程，可在终端设置代理后再构建：

  export HTTP_PROXY=http://127.0.0.1:7890
  export HTTPS_PROXY=http://127.0.0.1:7890
  cd android && ./gradlew assembleDebug
  

额外检查项 #

• 在Android Studio的Settings -> Appearance & Behavior -> System Settings -> Android SDK -> SDK Update Sites中，将Android SDK更新源替换为国内镜像（如阿里云）。
• 确认package.json中React Native版本为稳定发行版，beta版本可能存在依赖源异常。

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