PyTorch 安装时遇到的 SSL 验证错误：如何解决？

2024-03-19 23:37:31

Python 中使用 Pip 安装 PyTorch 时的 SSL 验证错误

概述

PyTorch 是一种深度学习框架，它提供了一个用于 Python 的强大张量计算库。在使用 Pip 在 Windows 10 上安装 PyTorch 时，可能会遇到 SSL 验证错误。本文将探讨导致此错误的原因，并提供通过 Pip 命令和 Pip 配置文件解决此问题的解决方案。

错误原因

SSL 验证错误通常是由以下原因引起的：

Pip 无法验证安装包的数字证书。
由于缺乏对下载源的信任，导致证书链中断。

在 PyTorch 的情况下，错误可能是由 Pip 无法验证 PyTorch 下载源 download.pytorch.org 的证书引起的。

解决方案

1. 使用 --trusted-host 选项

一种解决方案是使用 --trusted-host 选项显式地信任下载源。以下命令将信任 download.pytorch.org 并安装 PyTorch：

pip install --trusted-host download.pytorch.org torch==1.7.0+cu101 -f https://download.pytorch.org/whl/torch_stable.html

2. 修改 Pip 配置文件

另一种解决方案是修改 Pip 配置文件以添加对 download.pytorch.org 的信任。在虚拟环境中，Pip 配置文件通常位于 /path/to/my/env/pip.conf。

向 Pip 配置文件添加以下内容：

[global]
trusted-host = pypi.python.org
               pypi.org
               files.pythonhosted.org
               download.pytorch.org

保存 Pip 配置文件并重新运行 Pip 命令：

pip install torch==1.7.0+cu101

3. 禁用 SSL 验证

不推荐 在生产环境中禁用 SSL 验证。然而，在某些情况下，它可能是一种可行的临时解决方案。通过添加 --no-verify 选项可以禁用 SSL 验证：

pip install --no-verify torch==1.7.0+cu101 -f https://download.pytorch.org/whl/torch_stable.html

注意事项

使用 --trusted-host 选项时，确保只信任来自已知来源的下载源。
禁用 SSL 验证会使你的系统容易受到中间人攻击。
修改 Pip 配置文件后，Pip 将信任所有列出的下载源，因此请谨慎添加新来源。

结论

通过使用 --trusted-host 选项或修改 Pip 配置文件，你可以解决 Pip 在安装 PyTorch 时发生的 SSL 验证错误。这些方法将允许你继续安装 PyTorch 并避免证书验证失败。但是，为了安全起见，我们建议只信任来自已知来源的下载源，并且不要在生产环境中禁用 SSL 验证。