Mac（10.12.6）下Android Studio连接GitLab仓库SSL握手失败求助

这种突然炸锅的Git SSL问题真的让人头大，我之前帮同事排查过类似的情况，给你整理几个实用的排查和解决步骤，应该能帮你搞定：

1. 先确认服务器端的变动 #

报错明确提到服务器需要客户端证书，首先得搞清楚是不是GitLab最近改了安全配置：

• 问问团队里的其他成员有没有同样的问题，如果大家都中招，那就是服务器端要求必须用客户端证书访问，得联系管理员拿到对应的证书文件；
• 如果只有你出现这个问题，那大概率是本地的证书配置出了问题，继续往下看。

2. 检查本地Git的SSL配置 #

先排查Git的配置有没有异常，打开终端操作：

• 进入你的项目目录，查看仓库级的SSL配置：

  git config --list | grep ssl
  

  看看有没有sslCert或sslKey的配置项，要是有，确认对应的证书文件是否存在、有没有过期。
• 查看全局Git的SSL配置：

  git config --global --list | grep ssl
  

  你提到把http全局配置设为false，应该是指http.sslVerify=false？但这个设置是关闭SSL验证，和“需要客户端证书”的问题不相关，反而有安全风险，建议先改回来：

  git config --global http.sslVerify true
  

3. 导入客户端证书到Mac钥匙串（如果服务器确实要求） #

如果确认服务器必须用客户端证书，拿到证书文件（通常是.pem或.pfx格式）后：

1. 打开Mac的「钥匙串访问」，选择「登录」钥匙串，切换到「证书」分类；
2. 把证书文件拖进钥匙串，或者通过「文件」→「导入项目」添加；
3. 右键点击刚导入的证书，选择「显示简介」，在「信任」选项卡中，把「使用此证书时」设为「始终信任」。

接着告诉Git使用这个证书，在项目目录执行：

# 如果证书在钥匙串里，可以直接指定钥匙串路径
git config sslCert "/Users/你的用户名/Library/Keychains/login.keychain-db"
# 或者指定具体的证书文件路径
git config sslCert "/path/to/your/client-cert.pem"
git config sslKey "/path/to/your/client-key.pem"

4. 检查Android Studio的Git配置 #

有时候Android Studio会用内置的Git，和系统Git的配置不共享，导致证书不生效：

• 打开Android Studio，进入「Preferences」→「Version Control」→「Git」；
• 确认「Path to Git executable」指向的是系统Git（比如/usr/bin/git），而不是AS内置的版本；
• 点击「Test」测试连接，看看会不会弹出证书相关的提示。

5. 重置Git SSL配置（如果配置混乱） #

如果之前改了一堆配置导致混乱，可以先重置全局的SSL相关设置：

git config --global --unset sslCert
git config --global --unset sslKey
git config --global --unset http.sslVerify

之后再根据服务器的要求重新配置证书。

6. 终端直接测试Git连接 #

在终端里尝试克隆仓库（如果允许的话），看看报错是否一致：

git clone https://你的GitLab仓库地址.git

如果终端也报错，那重点放在本地证书配置和服务器要求上；如果终端能成功，那就是Android Studio的配置问题，比如没读取到钥匙串里的证书，或者用了不同的Git版本。

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