适用范围与准备
适用于本人管理的Git HTTPS连接已有可信CA文件,却仍提示证书验证错误或文件读取失败。先确认服务域名和CA来源;本篇不要求安装陌生根证书,也不通过关闭证书验证恢复下载。
先区分原因
http.sslCAInfo指定用于校验对端的证书文件,但GIT_SSL_CAINFO环境变量可以覆盖它;实际TLS后端也会影响证书来源。Git文档特别说明schannel与Windows证书存储的关系,不能把另一台机器上的OpenSSL配置直接套用。
按顺序操作
- 记录完整错误,先区分找不到CA文件、证书链不受信任和证书名称不匹配。查看文件是否存在并可被当前用户读取,不把文件路径存在当成证书内容可信。
- 仅查询http.sslCAInfo与http.sslBackend相关配置及来源;再检查当前进程是否设置GIT_SSL_CAINFO。不要输出完整Git配置或全部环境变量,其中可能包含凭据。
- 确认CA文件由组织管理员或目标服务的可信渠道提供,核对有效期和适用对象。系统自带公开CA已可验证的网站,不因一条网络错误就追加陌生CA。
- 若环境使用可接受该CA文件的后端,用单次-c http.sslCAInfo指定绝对路径进行只读ls-remote;预先消除与之冲突的环境覆盖。本次参数不改变全局配置。
- 使用schannel时另查http.schannelUseSSLCAInfo和本机证书存储策略,交管理员确定正确证书入口。不要为了使示例生效而切换后端、跳过吊销检查或改sslVerify为false。
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来源,不上传私钥或整份用户配置。