Python 3.8.20 Windows如何解决pip安装包时出现的SSL证书验证错误？

Question

在Windows系统上使用Python 3.8.20时，通过pip安装包可能会遇到SSL证书验证错误，表现为“SSL: CERTIFICATE_VERIFY_FAILED”。此问题通常源于系统缺少最新CA证书或Python内置证书过期。解决方法如下：首先尝试更新pip至最新版本，运行`python -m pip install --upgrade pip`。若问题依旧，可重新安装Python，确保勾选“Install launcher for Windows”和“Add Python to PATH”选项，安装过程中会自动更新证书。另一种方法是手动更新证书，下载最新`cacert.pem`文件（来自https://curl.se/ca/cacert.pem），将其放置于Python安装目录下的`Lib\site-packages\certifi`文件夹，并设置环境变量或代码中指定证书路径。作为临时解决方案，可使用`--trusted-host`或`--cert`参数跳过验证，但不推荐用于生产环境，因存在安全风险。

Answer 1

1. 问题概述

在Windows系统上使用Python 3.8.20时，通过pip安装包可能会遇到SSL证书验证错误。具体表现为“SSL: CERTIFICATE_VERIFY_FAILED”错误信息。这一问题通常源于系统缺少最新的CA证书或Python内置的证书已过期。

以下是可能的原因：

• 操作系统未及时更新最新CA证书。
• Python自带的证书库（certifi）版本较旧。
• 网络环境存在中间人攻击或代理服务器干扰。

2. 分析过程

当运行`pip install package_name`命令时，如果出现上述错误，可以按照以下步骤逐步排查：

1. 检查当前pip版本是否为最新版本。
2. 确认Python安装路径下的证书文件是否有效。
3. 尝试手动指定证书路径，验证是否为证书文件问题。

以下是排查过程中可能用到的命令：

python -m pip --version
python -m pip install --upgrade pip

3. 解决方案

根据问题的具体原因，提供以下几种解决方案：

方法	描述
更新pip	运行`python -m pip install --upgrade pip`以确保pip为最新版本。
重新安装Python	重新安装Python时勾选“Install launcher for Windows”和“Add Python to PATH”，确保证书自动更新。
手动更新证书	下载最新`cacert.pem`文件并放置于Python安装目录下的`Lib\site-packages\certifi`文件夹中。

4. 手动更新证书流程图

以下是手动更新证书的流程图：

graph TD;
    A[开始] --> B{下载最新cacert.pem};
    B -->|是| C[保存至Python安装目录];
    C --> D[设置环境变量或代码中指定路径];
    D --> E[完成];

5. 临时解决方案

作为临时解决方案，可以使用`--trusted-host`或`--cert`参数跳过SSL验证。例如：

pip install package_name --trusted-host pypi.org
pip install package_name --cert path/to/certificate.pem

需要注意的是，这种方法仅适用于开发环境或测试场景，在生产环境中不推荐使用，因为可能存在安全风险。