【完美解决】Python报错：NotOpenSSLWarning: urllib3 v2 only supports OpenSSL 1.1.1+, currently the ‘ssl‘ modul

前言

最近在学习PyTorch的时候，遇到了一个报错如下：

NotOpenSSLWarning: 
urllib3 v2 only supports OpenSSL 1.1.1+, currently the 'ssl' module is compiled with 'LibreSSL 2.8.3'. 

See: https://github.com/urllib3/urllib3/issues/3020
1
2
3
4

本文通过3种处理方式，一步一步处理这个异常

环境

系统：mac sonoma 14.2.1
IDE：PyCharm 2023.2.5 (Community Edition)
Python：3.9.6

定位原因

这个报错是在引用urllib3库时，由于v2版本仅支持OpenSSL 1.1.1以上的版本，而当前的ssl模块的版本为LibreSSL 2.8.3

知道问题产生的原因后，那么我们就需要解决这个版本不同步的问题。

方法一

我们可以降低urllib3的版本，根据urllib3的发布日志来看，我们需要将urllib3的版本降低到1.x版本。具体操作根据你所使用的包管理器会略有不同，这里我演示pip如何操作

// 1. 卸载
pip uninstall urllib3
// 2. 指定版本重新安装
pip install urllib3==1.26.15
1
2
3
4

这个方法虽然可以解决问题，缺点是使用的是旧的版本

方法二

在报错信息中提到了一个github issues：https://github.com/urllib3/urllib3/issues/3020。从中我们能发现：
即当python版本为3.9.6时，它的ssl模块就是LibreSSL 2.8.3，那么这也为我们提供了思路，就是更换python版本。在这篇issus的回答中，答主使用了brew的python

brew install python
1

这条指令即下载了brew包管理器下最新版本的python，这样也能解决问题。

这个解决方法很方便，也很有效，缺点就是如果你是苹果用户，你就不能使用系统自带的python，或者你无法使用低版本的python。

方法三

那么有没有办法在python3.9.6的前提下，把ssl模块的版本提升呢？答案是肯定的，就是有点折腾。

python中的ssl模块在编译时就导入进去了，所以这个方法的关键是要在python编译时修改ssl模块的路径为openssl的路径。注意这里的编译是只python语言的编译，不是项目编译。

1. 下载源码
下载python的源码直接在官网下载就行：https://www.python.org/downloads/source/

2. 安装openssl

brew install openssl
1

3. 查看openssl安装路径

brew --prefix openssl
1

4. 重新编译Python，进入源码根目录

//1. 配置参数，其中“/opt/homebrew/opt/openssl@3”需要替换成第三步获取到的安装目录
./configure --with-openssl=/opt/homebrew/opt/openssl@3

//2. 开始编译
make

//3. 可选，如果你想让你自己通过源码编译的python作用在全局系统，就执行下面的，他会自动拷贝到系统bin目录下
sudo make install
1
2
3
4
5
6
7
8

5. 检查

如果编译成功，在根目录下会生成一个python.exe文件

此时运行这个exe，并执行如下代码

import ssl; print(ssl.OPENSSL_VERSION)
1

这样ssl的版本就替换好了