本文导读

展开导读

文档首页/ 代码托管 CodeArts Repo/ 常见问题/ 认证鉴权问题/ TLS协议握手失败并报错"ssl handshake failure"

TLS协议握手失败并报错"ssl handshake failure"

更新时间：2025-05-30 GMT+08:00

查看PDF

问题现象

本地执行如下命令，与指定服务器建立TLS1.0连接并获取其证书信息。

openssl s_client -connect test.com:443 -tls1

会出现如下报错信息：

CONNECTED(00000003)
140155533838224:error:1409442E:SSL routines:ssl3_read_bytes:tlsv1 alert protocol version:s3_pkt.c:1493:SSL alert number 70
140155533838224:error:1409E0E5:SSL routines:ssl3_write_bytes:ssl handshake failure:s3_pkt.c:659:
---
no peer certificate available
---
No client certificate CA names sent
---
SSL handshake has read 7 bytes and written 0 bytes
---
New, (NONE), Cipher is (NONE)
Secure Renegotiation IS NOT supported
Compression: NONE
Expansion: NONE
No ALPN negotiated
SSL-Session:
    Protocol  : TLSv1
    Cipher    : 0000
    Session-ID: 
    Session-ID-ctx: 
    Master-Key: 
    Key-Arg   : None
    Krb5 Principal: None
    PSK identity: None
    PSK identity hint: None
    Start Time: 1720443876
    Timeout   : 7200 (sec)
    Verify return code: 0 (ok)
---

原因分析

CodeArts Repo当前支持TLS1.2、TLS1.3协议版本。

处理方法

在Git Bash客户端执行如下命令，查看您的Git版本。
```
git --version
```
如果您的Git版本低于2.6.0，请将您本地的Git客户端升级到最新版本，最新版本的Git客户端默认支持TLSv1.2协议。如果您的Git版本不低于2.6.0，您也可以使用如下命令指定TLS协议的版本。
```
openssl s_client -connect test.com:443 -tls1_2
```

绝大多数流量不受此变化的影响。预计会有一些客户受到影响。大多数客户端都可以更新以使用TLSv1.2。

Git-Credential-Manager-for-Windows < v1.14.0

Git-Credential-Manager-for-Windows < v1.14.0不支持TLSv1.2。

可以通过更新到最新版Git客户端来解决,最新版版本的GitBash自带Git-Credential-Manager功能，只需要在安装时勾选即可。

Git on Red Hat 5，<6.8和<7.2

Red Hat 5,6和7随Git客户端一起提供，不支持TLSv1.2。这可以通过分别更新到版本6.8和7.2（或更高版本）来解决。Red Hat 5没有支持TLSv1.2的点发行版。建议Red Hat 5的用户升级到更新版本的操作系统。

Java发布

如Oracle博客文章中所述，默认情况下，TLSv1用于JDK8之前的JDK版本。JDK8更改了此行为，默认为TLSv1.2。在旧版本的JDK上运行的任何客户端（例如Eclipse自带的JGit这样的流行客户端）都会受到影响。这可以通过更新到JDK> = 8或明确选择在JDK 7中的TLSv1.2来解决（查看https.protocols JSSE调整参数）。不幸的是，JDK <= 6的版本不支持TLSv1.2。建议JDK <= 6的用户升级到较新版本的JDK。

Visual Studio

Visual Studio附带了特定版本的Git for Windows和Git Credential Manager for Windows（GCM）。 Microsoft已更新Visual Studio 2017的最新版本以与TLSv1.2 Git服务器配合使用。建议Visual Studio用户通过单击产品内通知标志或直接从IDE检查更新来升级到最新版本。 Microsoft已在Visual Studio开发人员社区支持论坛上提供了其他指导。

第三方Git图形客户端

如果您使用的是Eclipse、JetBrains、SourceTree、VSCode、Tower、TortoiseGit等第三方Git客户端时，建议下载最新的GitBash客户端，在工具中设置使用原生(Native)的Git，而不是Build-in类型。

IDEA设置方式

SourceTree设置方式

Eclipse设置方式

父主题： 认证鉴权问题

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问