Python 3.7.3安装第三方库报错SSL模块缺失怎么解决

蓝鲸
蓝鲸
发布时间:2026-11-17| 7人浏览过
原创

详细解析Python 3.7.3在安装第三方库时提示SSL模块不可用(pip is configured with locations that require TLS/SSL)的根本原因,提供Ubuntu/Debian与CentOS系统下的OpenSSL依赖补齐、OpenSSL 1.1.1源码编译、Python重编译以及动态链接库配置的完整解决方案。

在使用 Python 3.7.3 运行 pip install 安装第三方包时,如果遇到 pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available 或 Can't connect to HTTPS URL because the SSL module is not available 报错,核心原因是当前 Python 运行环境未能成功加载底层的 _ssl C 语言扩展模块。本文将先说明该问题的成因与判断依据,随后分别针对不同系统环境提供补齐依赖重编译、编译独立 OpenSSL 1.1.1,以及配置动态链接库的完整解决路径,并说明验证方式与临时替代方案。

Python 3.7.3安装第三方库报错SSL模块缺失怎么解决
图 1:Python 3.7.3 源码编译中 OpenSSL 依赖链与 pip 报错成因

一、为什么会出现 SSL 模块缺失报错

该错误绝大多数发生在 Linux(如 CentOS、Ubuntu、Debian)或特殊 macOS 环境中通过源码编译安装 Python 3.7.3 的场景下。Windows 官方安装包默认已打包 OpenSSL 动态库,一般不会出现此问题。

导致该报错的根本机制有两层:

  1. 编译时缺乏 OpenSSL 开发头文件与库:在执行 ./configure && make 编译 Python 源码时,构建系统会尝试检测系统中的 OpenSSL 头文件(如 openssl/ssl.h)。如果系统未安装 openssl-devel(RedHat/CentOS)或 libssl-dev(Debian/Ubuntu),Python 并不会中断整体编译,而是静默跳过 _ssl 模块的构建。编译完成后,生成的 Python 解释器可以正常运行基础代码,但任何依赖安全连接的功能均无法调用。
  2. Python 3.7 的最低 OpenSSL 版本限制:根据 Python 官方规范(PEP 644),从 Python 3.7 开始,标准库 ssl 要求底层 OpenSSL 版本必须不低于 1.0.2 或 1.1.x,不再支持旧版的 OpenSSL 0.9.8 及 1.0.1。例如在未更新的 CentOS 7 系统中,系统自带的 OpenSSL 经常是 1.0.1e 或 1.0.1f,即使安装了 openssl-devel,Python 3.7.3 的配置脚本也会判定其版本过低而拒绝编译 _ssl 模块。

二、问题排查与修复决策流程

在动手修改之前,先确认当前系统的 OpenSSL 版本,再决定是直接安装开发包重编译,还是需要手动编译新版 OpenSSL。

Python 3.7.3安装第三方库报错SSL模块缺失怎么解决
图 2:排查系统 OpenSSL 现状与方案选取流程图

三、方案一:系统 OpenSSL 版本符合要求时(>= 1.0.2)

如果当前系统为 Ubuntu 18.04/20.04、Debian 10/11 或较新的 Linux 发行版,执行 openssl version 输出的版本号通常已在 1.1.0 或 1.1.1 以上。此时仅需补齐开发库头文件,再回到 Python 3.7.3 源码目录重编译即可。

1. 安装缺失的依赖包

在 Debian / Ubuntu 系统中执行:

sudo apt-get update
sudo apt-get install -y build-essential libssl-dev zlib1g-dev libbz2-dev \
libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev \
xz-utils tk-dev libffi-dev liblzma-dev

如果在 openSUSE 或 Fedora 系统中:

sudo dnf install -y gcc openssl-devel bzip2-devel libffi-devel zlib-devel

2. 重新编译并安装 Python 3.7.3

进入 Python 3.7.3 源码解压目录,先清理历史编译产物,再重新配置与安装:

cd /path/to/Python-3.7.3

# 清理上一次未带 ssl 编译的临时目标文件
make clean

# 重新配置,--enable-optimizations 启用性能优化,--prefix 指定安装目录
./configure --prefix=/usr/local/python37 --enable-optimizations

# 编译并使用 altinstall 避免覆盖操作系统原生 python 链接
make -j $(nproc)
sudo make altinstall

四、方案二:系统 OpenSSL 过旧时(如 CentOS 7 源码编译 OpenSSL 1.1.1)

CentOS 7 默认仓库中的 OpenSSL 版本通常为 OpenSSL 1.0.1e-fips 或 OpenSSL 1.0.2k-fips。如果版本低于 1.0.2,即使安装了 openssl-devel,Python 3.7.3 在执行 ./configure 时仍会报错或忽略 _ssl。此时最稳妥的做法是:单独下载 OpenSSL 1.1.1 源码,编译安装到 /usr/local/openssl 独立目录,再让 Python 指向该路径。

Python 3.7.3安装第三方库报错SSL模块缺失怎么解决
图 3:针对旧版系统编译 OpenSSL 1.1.1 并配置 Python 3.7.3 的四步执行图

1. 安装编译环境基础依赖

sudo yum install -y gcc make gcc-c++ zlib-devel bzip2-devel \
libffi-devel perl perl-core wget

2. 编译并安装 OpenSSL 1.1.1

下载 OpenSSL 1.1.1 长期支持版本的源码并安装到独立目录:

cd /usr/local/src
sudo wget https://www.openssl.org/source/openssl-1.1.1w.tar.gz --no-check-certificate
sudo tar -zxvf openssl-1.1.1w.tar.gz
cd openssl-1.1.1w

# 配置安装路径为 /usr/local/openssl,shared 参数生成动态链接库
sudo ./config --prefix=/usr/local/openssl --openssldir=/usr/local/openssl shared zlib

sudo make -j $(nproc)
sudo make install

注意:强烈建议通过 --prefix=/usr/local/openssl 指定非系统默认目录,不要直接覆盖 /usr/lib64 或 /usr/bin 下的系统自带旧版 OpenSSL,否则容易破坏 CentOS 系统的 yum、rpm 等原生工具。

3. 配置动态链接库(ldconfig)

新安装的 OpenSSL 动态库位于 /usr/local/openssl/lib 下。如果不将该目录告知系统动态链接器,Python 在运行时会提示找不到 libssl.so.1.1 或 libcrypto.so.1.1:

# 将新库路径写入系统动态链接配置
echo "/usr/local/openssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1.conf

# 刷新动态链接库缓存
sudo ldconfig -v | grep ssl

4. 重新编译 Python 3.7.3 并指定 OpenSSL 路径

如果使用 Python 3.7.3 的 ./configure 参数:

cd /path/to/Python-3.7.3
make clean

# 显式传入 OpenSSL 路径与动态链接参数
./configure \
  --prefix=/usr/local/python37 \
  --with-openssl=/usr/local/openssl \
  --with-openssl-rpath=auto \
  --enable-optimizations

make -j $(nproc)
sudo make altinstall

5. 备用方案:修改 Modules/Setup 文件(若 configure 参数未能生效)

在个别 Linux 发行版中,--with-openssl 无法被老旧版本的 configure 脚本完全捕获,可以通过修改源码中的 Modules/Setup 静态指定:

# 编辑 Python 源码根目录下的 Modules/Setup
# 找到 SSL 配置段落(约 200-220 行附近),取消注释并修改为实际安装路径:

SSL=/usr/local/openssl
_ssl _ssl.c \
    -DUSE_SSL -I$(SSL)/include -I$(SSL)/include/openssl \
    -L$(SSL)/lib -lssl -lcrypto

修改保存后,直接执行 make -j $(nproc) && sudo make altinstall 即可强行开启 _ssl 模块构建。

五、验证 SSL 模块是否恢复正常

安装完成后,无需等到运行 pip 报错才发现问题,可通过 Python 内置命令直接验证底层 SSL 链接状态。

Python 3.7.3安装第三方库报错SSL模块缺失怎么解决
图 4:SSL 模块修复前后对照与标准验证序列

1. 检查 ssl 模块导入与绑定的 OpenSSL 版本

运行以下测试命令:

/usr/local/python37/bin/python3.7 -c "import ssl; print(ssl.OPENSSL_VERSION)"

如果配置无误,控制台会输出实际绑定的版本字符串,例如:

OpenSSL 1.1.1w  11 Sep 2023

若依然输出 No module named '_ssl',则说明编译阶段未能正确定位 OpenSSL 头文件或库文件,需核对 Modules/Setup 或检查编译输出日志中关于 _ssl 的告警信息。

2. 测试 pip 安装第三方包

/usr/local/python37/bin/pip3.7 install requests

此时 pip 能够正常与 PyPI 官方源建立 HTTPS 安全握手并顺利完成包下载。

六、应急权宜方案:使用 HTTP 镜像源与信任主机

注意:本方法属于临时规避手段,仅适用于急需在当前环境安装依赖、但暂无权限或时间重新编译 Python 的临时场景。长期开发与生产环境必须按照前文修复底层 SSL 模块。

由于报错发生的核心原因是 pip 无法建立 HTTPS 加密连接,如果临时改用纯 HTTP 镜像源,并通过 --trusted-host 告知 pip 信任该非加密主机,可以绕过本地对 SSL 模块的调用:

# 单次安装临时指定
pip3.7 install requests -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

# 或写入配置文件永久规避(仅建议测试环境使用)
mkdir -p ~/.pip
cat > ~/.pip/pip.conf <<EOF
[global]
index-url = http://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host = mirrors.aliyun.com
EOF

局限性说明:

  • 该方法仅解决 pip 下载环节,如果后续编写的 Python 代码本身需要发起 HTTPS 请求(例如调用 requests.get("https://...") 或标准库 urllib.request),程序在运行时依然会抛出 ssl 模块缺失异常。
  • 采用非加密 HTTP 传输存在内容被中间人篡改或劫持的安全风险。

七、总结与排查要点归纳

排查项 现象/诊断依据 对应处理动作
编译前依赖 缺少 openssl/ssl.h 头文件 安装 openssl-devel 或 libssl-dev
OpenSSL 版本 openssl version < 1.0.2(常见于 CentOS 7) 源码编译安装 OpenSSL 1.1.1 至 /usr/local/openssl
Python 编译参数 执行 make 时提示 Failed to build: _ssl 添加 --with-openssl 或修改 Modules/Setup 指定路径
动态库链接 运行时报 libssl.so.1.1: cannot open shared object file 将 OpenSSL 库路径添加至 /etc/ld.so.conf.d/ 并执行 ldconfig
最终验证 import ssl; print(ssl.OPENSSL_VERSION) 正常输出版本号即证明修复彻底
相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。