IntelliJ Gradle同步报错SSL peer shut down incorrectly问题求助

解决方案 #

核心原因 #

该报错为Gradle请求Maven中央仓库时TLS协议版本握手失败，与系统代理残留、Gradle运行JDK版本、仓库访问稳定性有关。 #

具体操作步骤 #

1. 清理全局代理残留
   打开你Mac用户主目录下的.gradle文件夹，找到gradle.properties文件，删除所有包含proxy的配置行，避免之前VPN遗留的全局代理配置生效。
2. 配置Gradle支持多版本TLS协议
   你可以选择在当前项目根目录的gradle.properties（没有就新建一个）中添加如下配置，或者写到上面提到的全局.gradle/gradle.properties中实现所有项目生效：

   systemProp.https.protocols=TLSv1.2,TLSv1.3
   systemProp.jdk.tls.client.protocols=TLSv1.2,TLSv1.3
   

3. 替换国内Maven镜像源提升访问稳定性
   修改项目build.gradle中的repositories块，优先使用阿里云公共镜像：

   repositories {
       maven { url 'https://maven.aliyun.com/repository/public' }
       mavenCentral()
   }
   

4. 升级Gradle运行的JDK版本
   低版本JDK对高版本TLS协议支持存在缺陷，建议将Gradle运行JDK升级到JDK8u301以上，或者直接使用JDK11、JDK17：
   打开IntelliJ设置 -> 构建、执行、部署 -> 构建工具 -> Gradle，找到「Gradle JVM」选项，选择符合要求的JDK版本即可。
5. 清理缓存重试
   点击IntelliJ右侧Gradle面板的刷新按钮，或者在项目根目录执行终端命令 ./gradlew clean build --refresh-dependencies 强制刷新依赖。

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