You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native应用无法安装至设备的问题解决请求

解决React Native中Gradle下载失败(UnknownHostException)的问题

从你的报错信息和环境来看,核心问题是网络无法连接到services.gradle.org,导致Gradle 2.14.1安装包下载失败,进而无法在模拟器上安装App。下面是几个针对性的解决办法:

1. 排查网络与代理设置

  • 先验证网络连通性:打开浏览器访问https://services.gradle.org/distributions/gradle-2.14.1-all.zip,如果无法打开,说明你的网络无法访问该域名,可能是网络限制、代理或防火墙导致的。
  • 如果你使用了代理,需要给Gradle配置代理:
    • 找到项目根目录下的android/gradle.properties文件(如果没有就新建),添加以下内容(替换成你的代理信息):
      systemProp.http.proxyHost=你的代理IP
      systemProp.http.proxyPort=代理端口
      systemProp.https.proxyHost=你的代理IP
      systemProp.https.proxyPort=代理端口
      
    • 也可以配置全局Gradle代理:在Windows用户目录(C:\Users\<你的用户名>)下找到.gradle文件夹,里面新建gradle.properties文件并添加上述代理配置。
  • 临时关闭防火墙或杀毒软件,确认是否是它们拦截了Gradle的网络请求。

2. 手动下载Gradle包并配置缓存

如果网络问题暂时无法解决,手动下载是最直接的办法:

  • 去Gradle官方镜像下载gradle-2.14.1-all.zip(确保文件名和版本完全一致)。
  • 找到本地Gradle缓存目录:Windows下路径通常是C:\Users\<你的用户名>\.gradle\wrapper\dists\gradle-2.14.1-all\,里面会有一个随机字符命名的文件夹(比如8bnwg5hd3w55iofp58khbp6yv)。
  • 把下载好的gradle-2.14.1-all.zip放到这个随机字符文件夹里,不需要解压。
  • 回到项目根目录,重新运行react-native run-android。

3. 调整Gradle配置(可选)

如果上述方法无效,你可以尝试修改项目的Gradle配置:

  • 打开项目android/gradle/wrapper/gradle-wrapper.properties文件,把distributionUrl的值改成你本地下载的zip文件路径,比如:
    distributionUrl=file\:///C\:/Users/xxx/Downloads/gradle-2.14.1-all.zip
    
    注意Windows路径要转义,用\分隔或者用正斜杠。
  • 也可以尝试升级Gradle版本(兼容你的React Native 0.55.4):打开android/build.gradle,把dependencies里的classpath 'com.android.tools.build:gradle:2.2.3'(对应Gradle 2.14.1)升级到classpath 'com.android.tools.build:gradle:2.3.3',同时修改gradle-wrapper.properties里的distributionUrl为https\://services.gradle.org/distributions/gradle-3.3-all.zip,再重新构建。

4. 清理缓存后重新构建

运行以下命令清理项目缓存,再尝试构建:

cd android
gradlew clean
cd ..
react-native run-android

内容的提问来源于stack exchange,提问作者Vivek

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.28 06:27:24