Git克隆/拉取报错SSL_ERROR_SYSCALL的解决求助
解决Windows 10下Git克隆/拉取时的SSL_ERROR_SYSCALL问题
我之前在公司工作机上遇到过完全一样的情况,Win7升Win10重装Git后就出了这个SSL连接错误,大概率和工作环境的网络限制或者新系统的配置差异有关,给你几个亲测有效的解决步骤:
1. 优先排查Git代理配置
工作机器基本都有代理设置,Win10的代理规则和Win7可能不一样,先检查Git的代理是否正确:
- 查看当前Git代理配置:
git config --global --get http.proxy git config --global --get https.proxy - 如果输出的代理地址已经失效或者和当前Win10系统的代理不一致,先清除旧配置:
git config --global --unset http.proxy git config --global --unset https.proxy - 然后根据公司当前的代理服务器信息重新配置(如果需要的话):
注意:如果公司用的是PAC自动代理,可能需要手动提取对应的代理地址,或者直接使用系统代理:git config --global https.proxy http://your-company-proxy:portgit config --global http.proxy auto
2. 尝试切换到SSH协议
HTTPS协议容易受代理、证书拦截影响,换成SSH协议往往能绕过这些问题:
- 首先在GitHub账号的「Settings」→「SSH and GPG keys」里添加你的本地SSH公钥(如果还没配置的话)
- 修改本地仓库的远程地址为SSH格式(如果已经克隆过仓库):
git remote set-url origin git@github.com:your-username/your-repo.git - 之后再执行
git pull,或者直接用SSH地址克隆新仓库:git clone git@github.com:your-username/your-repo.git
3. 检查防火墙/企业安全软件拦截
工作机的企业级防火墙、杀毒软件或者EDR工具可能会拦截Git的SSL连接请求:
- 如果有权限,可以临时关闭杀毒软件的网络保护功能,测试是否能正常拉取
- 若关闭后恢复正常,联系公司IT部门,把
github.com、*.githubusercontent.com域名加入白名单,或者放行Git客户端的网络访问权限
4. 更新Git或调整SSL验证设置
- 重装的Git版本可能比较旧,和Win10的系统组件兼容性不好,去Git官网下载最新稳定版覆盖安装,新版通常修复了不少SSL相关的兼容问题
- 临时关闭SSL验证(仅用于排查,不推荐长期使用,有安全风险):
如果执行后能正常操作,说明是系统SSL证书的问题,可以尝试手动导入GitHub的根证书到Windows证书存储中git config --global http.sslVerify false
5. 检查系统代理设置
Win10的系统代理可能和Git的配置不匹配:
- 打开「设置」→「网络和Internet」→「代理」,确认当前的代理设置是否正确
- 如果使用的是自动代理,确保PAC文件地址能正常访问,或者切换到手动代理后再测试Git操作
内容的提问来源于stack exchange,提问作者squashed.bugaboo




