You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

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
  • 更新AS自带JRE的SSL证书
    可能是AS自带的JRE缺少必要的证书导致握手失败,手动导入即可:

    1. 先关闭代理:打开AS设置(File > Settings > Appearance & Behavior > System Settings > HTTP Proxy),选择"No proxy"后点击"Apply"。
    2. 去Gradle依赖仓库(比如maven.google.com)下载站点的SSL证书(浏览器地址栏点击锁图标即可导出)。
    3. 打开命令行,进入AS的JRE目录下的lib/security文件夹,执行导入命令:
      keytool -importcert -alias gradle-repo -file /path/to/your/cert.crt -keystore cacerts
      
      输入密码changeit确认导入。
  • 降级Gradle版本适配AS 4.2
    AS 4.2默认搭配的Gradle版本可能存在兼容性问题,降级到稳定版试试:

    1. 打开项目根目录下的gradle/wrapper/gradle-wrapper.properties文件。
    2. 修改distributionUrl为稳定版本,比如:
      distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-all.zip
      
    3. 点击AS右上角的"Sync Now"同步项目,看错误是否消失。
  • 排查网络环境干扰
    有时候是网络代理、VPN或者防火墙拦截了SSL连接:

    • 暂时关闭VPN、代理软件,用直连网络尝试创建项目。
    • 检查系统防火墙是否允许Android Studio访问HTTPS端口(443),必要时添加放行规则。

这些方法都是针对AS 4.2版本SSL错误的常见解决方案,你可以先从修改Gradle配置开始尝试,大概率能解决问题。

内容的提问来源于stack exchange,提问作者Abd Al-Aziz Abdalluh

火山引擎 最新活动