首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >[python]Python报错:NotOpenSSLWarning: urllib3 v2 only supports OpenSSL 1.1.1+, currently the ‘ssl‘ mod

[python]Python报错:NotOpenSSLWarning: urllib3 v2 only supports OpenSSL 1.1.1+, currently the ‘ssl‘ mod

作者头像
云未归来
发布2025-07-20 15:42:12
发布2025-07-20 15:42:12
42300
代码可运行
举报
运行总次数:0
代码可运行

最近在学习paddlepocr的时候,遇到了一个报错如下:

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

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

环境

系统:docker ubuntu18.04 Python:3.8

定位原因

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

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

方法一

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

代码语言:javascript
代码运行次数:0
运行
复制
// 1. 卸载
pip uninstall urllib3
// 2. 指定版本重新安装
pip install urllib3==1.26.15

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

方法二

在报错信息中提到了一个github issueshttps://github.com/urllib3/urllib3/issues/3020。从中我们能发现:

即当python版本为3.9.6时,它的ssl模块就是LibreSSL 2.8.3,那么这也为我们提供了思路,就是更换python版本。在这篇issus的回答中,答主使用了brew的python

代码语言:javascript
代码运行次数:0
运行
复制
brew install python
  • 1

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

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

方法三

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

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

1. 下载源码 下载python的源码直接在官网下载就行:Python Source Releases | Python.org

2. 安装openssl

代码语言:javascript
代码运行次数:0
运行
复制
brew install openssl

3. 查看openssl安装路径

代码语言:javascript
代码运行次数:0
运行
复制
brew --prefix openssl

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

代码语言:javascript
代码运行次数:0
运行
复制
//1. 配置参数,其中“/opt/homebrew/opt/openssl@3”需要替换成第三步获取到的安装目录
./configure --with-openssl=/opt/homebrew/opt/openssl@3

//2. 开始编译
make

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

5. 检查

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

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

代码语言:javascript
代码运行次数:0
运行
复制
import ssl; print(ssl.OPENSSL_VERSION)

这样ssl的版本就替换好了

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2024-04-27,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 环境
  • 定位原因
  • 方法一
  • 方法二
  • 方法三
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档