Android Studio 4.2创建新项目时出现SSL Peer Shut Down Incorrectly错误寻求解决方案
解决Android Studio 4.2创建新项目时的SSL握手错误
我明白你更新到Android Studio 4.2后创建新项目时遇到了这两个烦人的SSL错误——"SSL peer shut down incorrectly"和"remote host terminated the handshake",多方查找都没解决确实挺闹心的。下面我整理了几个针对这个版本的有效解决方案,你可以逐一尝试:
修改Gradle配置跳过SSL验证
很多时候是Gradle拉取依赖时的SSL校验环节出了问题,直接调整配置就能绕开这个坑。打开项目根目录的gradle.properties文件,添加以下内容:# 清空代理配置(如果不需要代理的话) systemProp.http.proxyHost= systemProp.http.proxyPort= systemProp.https.proxyHost= systemProp.https.proxyPort= # 指定SSL协议和信任存储 org.gradle.jvmargs=-Djavax.net.ssl.trustStoreType=JKS -Djavax.net.ssl.trustStore=/path/to/your/cacerts -Djavax.net.ssl.trustStorePassword=changeit -Dhttps.protocols=TLSv1.2,TLSv1.1,TLSv1注意替换
/path/to/your/cacerts为Android Studio自带JRE的cacerts路径:- Windows:
C:\Program Files\Android\Android Studio\jre\lib\security\cacerts - Mac:
/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/lib/security/cacerts
默认密码都是changeit。
- Windows:
更新AS自带JRE的SSL证书
可能是AS自带的JRE缺少必要的证书导致握手失败,手动导入即可:- 先关闭代理:打开AS设置(File > Settings > Appearance & Behavior > System Settings > HTTP Proxy),选择"No proxy"后点击"Apply"。
- 去Gradle依赖仓库(比如maven.google.com)下载站点的SSL证书(浏览器地址栏点击锁图标即可导出)。
- 打开命令行,进入AS的JRE目录下的
lib/security文件夹,执行导入命令:
输入密码keytool -importcert -alias gradle-repo -file /path/to/your/cert.crt -keystore cacertschangeit确认导入。
降级Gradle版本适配AS 4.2
AS 4.2默认搭配的Gradle版本可能存在兼容性问题,降级到稳定版试试:- 打开项目根目录下的
gradle/wrapper/gradle-wrapper.properties文件。 - 修改
distributionUrl为稳定版本,比如:distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-all.zip - 点击AS右上角的"Sync Now"同步项目,看错误是否消失。
- 打开项目根目录下的
排查网络环境干扰
有时候是网络代理、VPN或者防火墙拦截了SSL连接:- 暂时关闭VPN、代理软件,用直连网络尝试创建项目。
- 检查系统防火墙是否允许Android Studio访问HTTPS端口(443),必要时添加放行规则。
这些方法都是针对AS 4.2版本SSL错误的常见解决方案,你可以先从修改Gradle配置开始尝试,大概率能解决问题。
内容的提问来源于stack exchange,提问作者Abd Al-Aziz Abdalluh




