适用范围与准备

适用于本人管理的Git HTTPS连接已有可信CA文件,却仍提示证书验证错误或文件读取失败。先确认服务域名和CA来源;本篇不要求安装陌生根证书,也不通过关闭证书验证恢复下载。

先区分原因

http.sslCAInfo指定用于校验对端的证书文件,但GIT_SSL_CAINFO环境变量可以覆盖它;实际TLS后端也会影响证书来源。Git文档特别说明schannel与Windows证书存储的关系,不能把另一台机器上的OpenSSL配置直接套用。

按顺序操作

  1. 记录完整错误,先区分找不到CA文件、证书链不受信任和证书名称不匹配。查看文件是否存在并可被当前用户读取,不把文件路径存在当成证书内容可信。
  2. 仅查询http.sslCAInfo与http.sslBackend相关配置及来源;再检查当前进程是否设置GIT_SSL_CAINFO。不要输出完整Git配置或全部环境变量,其中可能包含凭据。
  3. 确认CA文件由组织管理员或目标服务的可信渠道提供,核对有效期和适用对象。系统自带公开CA已可验证的网站,不因一条网络错误就追加陌生CA。
  4. 若环境使用可接受该CA文件的后端,用单次-c http.sslCAInfo指定绝对路径进行只读ls-remote;预先消除与之冲突的环境覆盖。本次参数不改变全局配置。
  5. 使用schannel时另查http.schannelUseSSLCAInfo和本机证书存储策略,交管理员确定正确证书入口。不要为了使示例生效而切换后端、跳过吊销检查或改sslVerify为false。
Git 只读配置查询;无匹配时退出非零不等于联网失败,不打印全部配置
git config --show-origin --get-all http.sslCAInfo
git config --show-origin --get-all http.sslBackend
git config --show-origin --get-all http.schannelUseSSLCAInfo
观察项含义与下一步
http.sslCAInfo证书文件配置
GIT_SSL_CAINFO可覆盖文件选择的环境变量
schannel须核对Windows证书存储及专用选项

怎样确认有效

原来的证书错误消失,并返回预期仓库的引用,才说明校验与访问路径同时通过。后续出现401或403属于认证授权问题,不能据此继续修改CA。

无效时恢复与下一步

撤销单次参数或恢复自己改过的变量与配置;保留原CA文件。仍然失败时提供脱敏的域名、TLS后端、错误原文及CA来源,不上传私钥或整份用户配置。