Python小白必看：urllib3报错怎么办？5分钟搞定OpenSSL问题

原创于 2025-12-19 10:32:07 发布 · 615 阅读

CC 4.0 BY-SA版权

快速体验

打开 InsCode(快马)平台 https://www.inscode.net

输入框内输入如下内容：

创建一个面向初学者的图文教程，逐步指导解决'ImportError: urllib3 v2 only supports OpenSSL 1.1.1+'错误。包含：1) 错误截图示例 2) 检查OpenSSL版本的简单命令 3) 三种适合新人的解决方案 4) 验证问题是否解决的步骤。要求使用最基础的术语，每个步骤附带命令行示例和预期输出。

点击'项目生成'按钮，等待项目生成完整后预览效果

示例图片

作为Python初学者，遇到各种报错是常有的事。最近我在使用urllib3这个库时，就碰到了这样一个错误：'ImportError: urllib3 v2 only supports OpenSSL 1.1.1+'。刚开始完全摸不着头脑，经过一番摸索后，终于搞清楚了原因和解决方法。今天我就用最通俗易懂的方式，把这个问题的来龙去脉和解决步骤分享给大家。

1. 为什么会报这个错？

这个错误其实是在告诉我们，当前安装的urllib3版本需要OpenSSL 1.1.1或更高版本才能运行，而我们的系统里安装的OpenSSL版本太低了。OpenSSL是一个加密工具包，很多网络相关的Python库（比如urllib3）都需要依赖它。

2. 如何检查OpenSSL版本？

在解决问题之前，我们需要先确认自己的OpenSSL版本。打开终端或命令行，输入以下命令：

在Windows系统上：
```
openssl version
```
在Mac或Linux系统上：
```
openssl version
```

如果输出显示版本号低于1.1.1，比如1.0.2或更低，那就说明遇到了这个问题。

3. 三种适合新人的解决方案

方法一：升级OpenSSL

这是最彻底的解决方案，但可能稍微复杂一些。不同系统升级方法不同：

Windows用户：可以下载OpenSSL 1.1.1+的安装包手动安装
Mac用户：使用Homebrew命令 brew upgrade openssl
Linux用户：使用系统包管理器，如 sudo apt-get update && sudo apt-get upgrade openssl

方法二：降级urllib3

如果你暂时不想或不能升级OpenSSL，可以选择安装一个旧版本的urllib3：

先卸载当前版本：
```
pip uninstall urllib3
```
安装兼容的旧版本：
```
pip install urllib3==1.26.0
```

方法三：使用虚拟环境

如果你需要在不同项目中使用不同版本的库，可以创建一个虚拟环境：

创建虚拟环境：
```
python -m venv myenv
```
激活虚拟环境：
Windows: myenv\Scripts\activate
Mac/Linux: source myenv/bin/activate
在虚拟环境中安装特定版本的urllib3

4. 验证问题是否解决

无论采用哪种方法，最后都要验证一下问题是否真的解决了：

打开Python解释器：
```
python
```
尝试导入urllib3：
```
import urllib3
```
如果没有报错，就说明问题解决了

5. 常见问题

Q：为什么我升级了OpenSSL但问题依旧？ A：可能需要重启终端或电脑，让系统加载新的OpenSSL版本
Q：降级urllib3会影响其他程序吗？ A：可能会有影响，建议使用方法三的虚拟环境方案
Q：我是完全的新手，哪种方法最简单？ A：方法二（降级urllib3）最简单快捷

遇到这类问题时，最重要的是不要慌张。Python的报错信息看起来可能很可怕，但其实往往都提供了有用的线索。通过这次经历，我学到了两点重要的经验：一是要仔细阅读错误信息，它通常会告诉你问题的关键；二是在安装Python库时要注意版本兼容性问题。

如果你刚开始学习Python，可能会觉得这些配置问题很麻烦。其实可以使用一些在线的Python环境来避免本地配置的困扰。比如InsCode(快马)平台就提供了即开即用的Python环境，不用操心这些依赖问题，特别适合新手快速上手。我个人体验过几次，发现它对于学习Python基础知识特别友好，省去了很多环境配置的麻烦。

快速体验

打开 InsCode(快马)平台 https://www.inscode.net

输入框内输入如下内容：

创建一个面向初学者的图文教程，逐步指导解决'ImportError: urllib3 v2 only supports OpenSSL 1.1.1+'错误。包含：1) 错误截图示例 2) 检查OpenSSL版本的简单命令 3) 三种适合新人的解决方案 4) 验证问题是否解决的步骤。要求使用最基础的术语，每个步骤附带命令行示例和预期输出。