OpenSSL 库冲突导致 Python 3.14.2 编译失败

秦渝兴

460人浏览 · 2026-03-11 17:49:27

秦渝兴 · 2026-03-11 17:49:27 发布

前言

最近想在 Redhat Enterprise Linux 9.6 上编译安装 Python 3.14.2，本以为只是简单的 ./configure && make && make install，结果却踩进了 OpenSSL 版本冲突的大坑。花了不少时间排查，最终发现解决问题的关键不是“升级 OpenSSL”，而是 “让 Python 用对库，别管命令”。本文将记录这次排错的全过程，希望能帮到遇到类似问题的朋友。

一、环境背景

· 操作系统：Red Hat Enterprise Linux 9.6 · Python 版本：3.14.2（源码编译） · 系统默认 OpenSSL 版本：3.2.2（由 openssl-devel 包提供） · 问题起因：系统可能存在之前手动安装的更高版本 OpenSSL 痕迹，导致 openssl 命令与系统库版本不一致。

二、错误现象

2.1 编译失败

执行 ./configure 时，出现如下错误：

could not build the ssl module!
Python requires an OpenSSL 1.1.1 or newer

显然 Python 找不到可用的 SSL 开发库。

2.2 openssl version 也报错

尝试查看 OpenSSL 版本时，得到诡异的错误：

$ openssl version
openssl: /lib64/libssl.so.3: version `OPENSSL_3.4.0' not found (required by openssl)
openssl: /lib64/libcrypto.so.3: version `OPENSSL_3.3.0' not found (required by openssl)
...

这说明系统里同时存在多个版本的 OpenSSL 库，openssl 命令链接的库版本太低，而命令本身期望更高版本，导致运行失败。

三、排查过程

3.1 确认 OpenSSL 开发库是否安装

首先检查开发包：

yum list installed | grep openssl

发现 openssl-devel-3.2.2-6.el9.x86_64 已安装。理论上 Python 编译需要头文件和库，这应该够了，但为什么还是失败？

3.2 检查头文件位置

/usr/include/openssl/ssl.h 存在，说明头文件正常。

3.3 查看编译日志

重新运行 ./configure 并将输出保存：

./configure --prefix=/usr/local --with-openssl=/usr 2>&1 | tee config.log

搜索 ssl 关键字，发现 configure 脚本确实找到了 OpenSSL，但后续编译时却报告找不到某些符号。

3.4 怀疑多个 OpenSSL 版本冲突

用 whereis openssl 看到多个路径：

· /usr/bin/openssl（系统自带） · /usr/local/bin/openssl（手动安装的高版本痕迹）

用 ldd /usr/bin/openssl 查看依赖：

$ ldd /usr/bin/openssl | grep ssl
libssl.so.3 => /lib64/libssl.so.3 (0x...)

库来自 /lib64，版本 3.2.2，但命令本身可能是更高版本编译的，导致版本不匹配。

3.5 尝试清理手动安装的 OpenSSL

将 /usr/local/bin/openssl 移走（避免干扰）：

mv /usr/local/bin/openssl /usr/local/bin/openssl.bak

并检查 /usr/local/lib 下是否有手动安装的库文件：

ls -l /usr/local/lib/libssl*

发现没有，说明之前手动安装可能只是命令，没有库。

3.6 重新安装系统 OpenSSL 包

为了确保命令和库一致，强制重新安装：

yum reinstall -y openssl openssl-devel

但 openssl version 依然报同样的错——看来系统里的命令已经“坏”了，无法通过包管理器修复。

四、退而求其次的解决方案

4.1 意识到 Python 不需要 openssl 命令

Python 编译只需要 OpenSSL 的头文件和库文件，并不需要 openssl 这个可执行程序。只要库文件存在且版本足够，ssl 模块就能编译成功。

4.2 强行编译 Python

再次执行编译，这次不再纠结 openssl version 的错误：

cd Python-3.14.2
make clean
./configure --prefix=/usr/local --with-openssl=/usr
make -j$(nproc)
make altinstall

奇迹般地，编译顺利完成！

4.3 验证 Python SSL 模块

$ /usr/local/bin/python3.14 -c "import ssl; print('SSL available:', ssl.OPENSSL_VERSION)"
SSL available: OpenSSL 3.2.2 4 Jun 2024

成功！Python 3.14.2 已经正常使用系统 OpenSSL 3.2.2。

4.4 openssl 命令依然冲突

虽然 Python 工作了，但 openssl version 依旧报同样的错误。不过既然不影响开发，暂时选择忽略。

五、总结与建议

OpenSSL 有两个部分：开发库（openssl-devel）供编译用，和命令行工具（openssl）供用户使用。Python 只需要前者。
版本冲突不可怕：只要库文件正确，即使 openssl 命令坏掉，也可以继续编译。
排查思路： · 首先确认开发包是否安装。 · 查看头文件位置。 · 用 ldd 检查命令依赖的库路径。 · 如果手动安装过高版本，建议暂时移走，避免干扰。
最终选择：在无法彻底修复 openssl 命令的情况下，接受系统原有版本（3.2.2）作为 Python 的 SSL 后端，它完全满足需求。
后续：如果将来确实需要更高版本的 OpenSSL，可以考虑在 /usr/local 下独立编译并指定 --with-openssl=/usr/local/openssl 重新编译 Python，但当前不必折腾。