解决 Git SSL 连接错误：OpenSSL SSL_read: SSL_ERROR_SYSCALL, errno

狐572025-01-14 10:39

问题描述

在执行 git pull 命令时遇到以下错误：

bash 复制代码

> git pull --tags origin main
fatal: unable to access 'github仓库': OpenSSL SSL_read: SSL_ERROR_SYSCALL, errno 0

这个错误通常表示 Git 在尝试通过 HTTPS 连接到 GitHub 时遇到了 SSL 连接问题。

解决方案

1. 检查网络连接

首先，确保你的网络连接正常：

bash 复制代码

# 测试与 GitHub 的连接
ping github.com

2. 禁用 SSL 验证

如果网络正常但仍然无法连接，可以尝试禁用 SSL 验证：

bash 复制代码

git config --global http.sslVerify "false"

3. 更新 Git 凭据

重置并更新你的 Git 凭据：

bash 复制代码

# 移除系统级凭据
git config --system --unset credential.helper

# 设置全局凭据管理器
git config --global credential.helper manager

4. 代理设置

如果你使用代理服务器：

bash 复制代码

# 设置代理
git config --global http.proxy http://proxyserver:port

# 取消代理设置
git config --global --unset http.proxy

5. 更新 SSL 证书设置

重新配置 SSL 后端和证书：

bash 复制代码

git config --global http.sslBackend openssl
git config --global http.sslCAInfo /path/to/ca-bundle.crt

6. 切换到 SSH 连接

如果 HTTPS 持续出现问题，可以考虑使用 SSH：

bash 复制代码

# 1. 生成 SSH 密钥
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

# 2. 更改仓库远程 URL
git remote set-url origin git@github.com:username/repository.git

临时解决方案

有时这只是临时的网络问题，可以尝试：

bash 复制代码

# 多次尝试
git pull --tags origin main