本文详解 CentOS 系统下 Python 3.10 因 SSL 模块缺失导致 get-pip.py 安装失败（报错“SSL module not available”）的根本原因与分步修复方法，涵盖依赖检查、系统库安装及源码编译等关键操作。
本文详解 centos 系统下 python 3.10 因 ssl 模块缺失导致 `get-pip.py` 安装失败（报错“ssl module not available”）的根本原因与分步修复方法，涵盖依赖检查、系统库安装及源码编译等关键操作。
该错误并非 pip 本身的问题，而是 Python 解释器在构建时缺失 SSL 支持所致。核心表现为：执行 python get-pip.py 时反复提示 SSLError("Can't connect to HTTPS URL because the SSL module is not available.")，最终因无法访问 PyPI（https://www.php.cn/link/4fc9669f543abba50fd776facbcd7694 Could not find a version that satisfies the requirement pip (from versions: none)。
? 第一步：诊断 SSL 状态
运行以下两条命令，快速定位问题根源：
# 检查系统 OpenSSL 是否已安装 openssl version # 检查 Python 是否能加载 ssl 模块及其底层 OpenSSL 版本 python -c "import ssl; print(ssl.OPENSSL_VERSION)"
- ✅ 若 openssl version 成功输出（如 OpenSSL 1.1.1k FIPS 25 Mar 2021），但 python -c "import ssl..." 报错 ModuleNotFoundError: No module named 'ssl' 或 AttributeError，说明 Python 编译时未链接 OpenSSL；
- ⚠️ 若两条命令均失败或 openssl version 报 command not found，则属于 系统级 OpenSSL 缺失，需优先安装基础加密库。
? 第二步：修复方案（按优先级选择）
方案一：补全系统 OpenSSL 依赖（适用于大多数 CentOS 7/8）
# CentOS 7
sudo yum install -y openssl openssl-devel
# CentOS 8 / Stream
sudo dnf install -y openssl openssl-devel
# 安装完成后，验证 Python ssl 模块是否可用
python -c "import ssl; print('SSL OK:', ssl.OPENSSL_VERSION)"? 注意：仅安装 openssl 包通常不够，openssl-devel（含头文件和静态库）是 Python 编译时链接 SSL 所必需的。若此前为最小化安装系统，此步骤常可直接解决问题。
方案二：重新编译 Python 3.10（当方案一无效时）
若确认系统已安装 openssl-devel，但 python -c "import ssl" 仍失败，则原始 Python 构建未启用 SSL 支持。此时需从源码重建：
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
# 1. 安装编译依赖（关键！）
sudo yum groupinstall -y "Development Tools"
sudo yum install -y openssl-devel bzip2-devel libffi-devel zlib-devel
# 2. 下载并解压 Python 3.10 源码（以 3.10.0 为例）
wget https://www.python.org/ftp/python/3.10.0/Python-3.10.0.tgz
tar -xzf Python-3.10.0.tgz
cd Python-3.10.0
# 3. 配置：显式启用 SSL 支持（自动探测 OpenSSL 路径）
./configure --enable-optimizations --with-ssl
# 4. 编译并安装（--prefix 可选，避免覆盖系统 Python）
make -j$(nproc)
sudo make altinstall # 推荐使用 altinstall 避免覆盖 /usr/bin/python
# 5. 验证新 Python 的 SSL 能力
/usr/local/bin/python3.10 -c "import ssl; print('Built with SSL:', ssl.OPENSSL_VERSION)"✅ 成功后，即可安全运行：
/usr/local/bin/python3.10 get-pip.py
✅ 最终验证与建议
安装完成后，执行以下命令确认环境健康：
python3.10 -m pip --version # 应输出 pip 版本及 Python 路径
python3.10 -c "import urllib.request; urllib.request.urlopen('https://pypi.org')" # 测试 HTTPS 连接⚠️ 重要提醒：
- 不要使用 --trusted-host pypi.org 或 --index-url http://... 绕过 HTTPS —— 这会带来严重安全风险，且无法解决根本问题；
- 若使用容器或 CI 环境，请在 Dockerfile 中提前安装 openssl-devel 并确保 ./configure --with-ssl 步骤存在；
- CentOS Stream 用户注意：dnf 替代 yum，但包名一致。
通过以上步骤，您将获得一个具备完整 TLS/SSL 能力的 Python 3.10 环境，pip 可稳定连接 PyPI 并管理第三方包——这是现代 Python 开发不可或缺的安全基石。
