AppCenter构建时出现javax.net.ssl.SSLException: readHandshakeRecord错误

问题根因 #

你本地构建正常是因为本地已经缓存了gradle-7.0.2的安装包，无需重新下载。AppCenter构建机为干净的临时环境，每次构建都需要从远程地址拉取Gradle安装包，报错本质是构建机到Gradle官方下载源的网络连通性故障，SSL握手阶段连接被中断，所以修改HTTP/HTTPS协议无法解决问题。

可行解决方案 #

• 方案1：替换Gradle下载源为稳定镜像
  修改项目下gradle/wrapper/gradle-wrapper.properties文件，将distributionUrl参数替换为可稳定访问的镜像地址，示例配置如下：

# 可替换为你所在区域访问稳定的Gradle镜像地址
distributionUrl=https://mirrors.aliyun.com/maven/gradle/gradle-7.0.2-bin.zip

修改后提交代码到Bitbucket分支重新触发构建即可。

• 方案2：开启AppCenter构建缓存
  进入AppCenter对应项目的构建设置页面，开启「构建缓存」开关，首次构建成功下载Gradle包后，后续构建会直接复用缓存的安装包，无需重复发起下载请求，可避免重复触发网络问题。

• 方案3：配置构建机网络规则
  如果你的AppCenter是私有部署实例，请排查构建机出口防火墙规则：

1. 确认是否开放了Gradle下载源的访问权限
2. 若存在SSL代理拦截，需要在项目根目录的gradle.properties中添加代理配置：

systemProp.http.proxyHost=你的代理IP
systemProp.http.proxyPort=代理端口
systemProp.https.proxyHost=你的代理IP
systemProp.https.proxyPort=代理端口
# 若代理需要认证，添加以下两行
systemProp.http.proxyUser=代理用户名
systemProp.http.proxyPassword=代理密码

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