Using Gradle Behind Proxy

原文地址:https://alphahinex.github.io/2020/01/05/using-gradle-behind-proxy/

在网络代理环境下使用 Gradle 时,可能会遇到以下三个问题:

  1. gradlew 下载对应 Gradle 发布版时无法下载
  2. 下载依赖时,提示连接超时
  3. SSL 证书无效

gradlew 下载对应 Gradle 发布版时无法下载

错误提示

Unable to tunnel through proxy. Proxy returns "HTTP/1.1 407 Proxy Authorization Required"

原因

wrapper 下载发布包时也需要配置代理

解决办法

试遍各种为 wrapper 配置代理的方法,均无果。用最直接的办法:按照 gradle.propertiesdistributionUrl 路径,手动下载好发布包,放到 wrapper 自动创建的路径下(如:~/.gradle/wrapper/dists/gradle-6.0.1-all/99d3u8wxs16ndehh90lbbir67),继续执行 gradlew 命令即可。

下载依赖时,提示连接超时

错误提示

> Connection timed out: connect

原因

需为 Gradle 配置代理参数

解决办法

gradle.properties 中添加如下内容(注意修改各参数值):

systemProp.http.proxyHost=www.somehost.org
systemProp.http.proxyPort=8080
systemProp.http.proxyUser=userid
systemProp.http.proxyPassword=password
systemProp.http.nonProxyHosts=*.nonproxyrepos.com|localhost

systemProp.https.proxyHost=www.somehost.org
systemProp.https.proxyPort=8080
systemProp.https.proxyUser=userid
systemProp.https.proxyPassword=password
systemProp.https.nonProxyHosts=*.nonproxyrepos.com|localhost

SSL 证书无效

错误提示

> sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

原因

错误提示中,unable to find valid certification pathPKIX path building failed 表明了这是因 SSL 证书引起的问题。
在通过代理访问网络时,可能需要在本地添加需要信任的根证书(在未添加根证书并信任时,无法通过浏览器访问 https 站点)。
在此种环境下,需要为 Gradle 所使用的 Java 也进行类似操作,才能通过 Java 代码访问 https 资源(如:https://plugins.gradle.org/)。

解决办法

1. 确定 Gradle 所使用的 Java 路径

先找到 Gradle 所使用的 Java home,可通过 ./gradlew -v 查看所使用的 Java 版本。

2. 查看 JDK 中已存在的证书

假设已定义了环境变量 JAVA_HOME 代表 JDK 安装路径,可通过如下命令查看 keystore 中已经存在的证书:

$ keytool -list -keystore $JAVA_HOME/jre/lib/security/cacerts

提示需要输入密码时,直接回车即可。

3. 导入新证书

将网络代理方提供的根证书导入到 keystore 中(注意修改 <> 中变量):

$ sudo keytool -import -alias  -keystore $JAVA_HOME/jre/lib/security/cacerts -file 

默认密码:changeit

4. 配置信任证书

证书导入至 keystore 之后,还需将其加入 truststore。

gradle.properties 中添加如下内容(注意修改 <> 中内容):

systemProp.javax.net.ssl.trustStore=/jre/lib/security/cacerts
systemProp.javax.net.ssl.trustStorePassword=changeit

配置完成后,可能需要重新开启终端,继续执行 Gradle 命令,即可生效。

参考资料

  1. Solutions for “Unable to resolve dependency” on building with Android Studio 3.0
  2. AndroidStudio构建项目异常:PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderE...
  3. import a .cer file to .keysore file
  4. Truststore setup for gradle plugin in IntelliJ
  5. How to tell Maven to disregard SSL errors (and trusting all certs)?

你可能感兴趣的:(Using Gradle Behind Proxy)