摘要：本文针对 Python 开发中 pip 安装依赖时出现的SSLZeroReturnError报错，深入剖析系统根证书缺失、Python ssl 模块异常等核心诱因，提供 3 种分级解决方案，从临时绕开到系统级根治，助力开发者快速修复环境配置。

一、问题现象与根源分析

1. 核心报错表现

在执行pip install opencv-python或pip install -r requirements.txt安装依赖时，终端抛出典型 SSL 验证错误。

SSLError(SSLZeroReturnError(6, 'TLS/SSL connection has been closed (EOF) (_ssl.c:1149)'))

更换清华、阿里云等国内镜像源后问题复现，最终提示Could not find a version that satisfies the requirement，实际并非依赖包不存在，而是 pip 无法通过 HTTPS 验证镜像源合法性。

2. 问题本质总结

报错根源集中在两层证书信任体系异常：

• 系统层：Windows 根证书缺失、过期或证书存储目录损坏，无法验证 HTTPS 网站的 SSL 证书；
• Python 层：Python 的ssl模块损坏，或证书管理库certifi的根证书文件cacert.pem陈旧，导致 Python 无法调用系统证书完成验证。

二、3种分级解决方案

（1）关闭 Python SSL 验证（高级操作，彻底禁用 SSL 校验）

若你想继续使用网络安装，可通过修改环境变量强制关闭 Python 的 SSL 验证，步骤如下：

1. 打开 PowerShell，执行以下命令设置环境变量（临时生效，仅当前窗口）：

# 禁用Python SSL证书验证
$env:PYTHONHTTPSVERIFY = "0"
# 禁用pip SSL证书验证
$env:PIP_TRUSTED_HOST = "pypi.doubanio.com,mirrors.aliyun.com,pypi.tuna.tsinghua.edu.cn,pypi.org,files.pythonhosted.org"

     2.再次执行安装命令（豆瓣 HTTP 源）：

pip install opencv-python -i http://pypi.doubanio.com/simple/

（2）使用 Conda 安装（若已安装 Anaconda/Miniconda）

Conda 的包管理不受 pip 的 SSL 配置影响，且不会自动重定向，步骤如下：

1. 打开 Anaconda Prompt（或在当前 PowerShell 中激活环境）：

conda activate vision_project

     2.执行安装命令（无需担心 SSL 问题）

# 安装OpenCV（conda-forge源稳定可靠）
conda install -c conda-forge opencv -y

     3.安装完成后，用python -c "import cv2; print(cv2.__version__)"验证。

（3）彻底重置 Windows 证书系统（底层根治）

这是解决系统证书存储损坏、根证书缺失的终极操作，执行后系统会重建完整证书体系：

# 1. 停止所有证书相关服务
net stop cryptsvc
net stop wuauserv
net stop bits

# 2. 备份并删除旧证书存储目录（系统会自动重建）
if (Test-Path "C:\Windows\System32\catroot2") {
    ren C:\Windows\System32\catroot2 catroot2_old
}
if (Test-Path "C:\Windows\System32\Certificates") {
    ren C:\Windows\System32\Certificates Certificates_old
}
if (Test-Path "C:\Users\用户\AppData\Roaming\Microsoft\SystemCertificates") {
    ren C:\Users\用户\AppData\Roaming\Microsoft\SystemCertificates SystemCertificates_old
}

# 3. 清理证书缓存
certutil -delstore -user my *
certutil -delstore -user root *
certutil -delstore my *
certutil -delstore root *

# 4. 重启证书相关服务，系统自动同步最新根证书
net start cryptsvc
net start wuauserv
net start bits

# 5. 强制更新系统根证书
certutil -generateSSTFromWU roots.sst
certutil -addstore root roots.sst
del roots.sst

执行完上述命令后，必须重启电脑（重启后系统会自动下载并安装所有可信根证书，这一步是关键，不可跳过）。

以上三种方法我用的第三种，解决了。