解决`pipisconfiguredwithlocationsthatrequireTLS/SSL`错误

问题描述

在使用 pip 安装 Python 包时，可能会遇到以下错误：

WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.

这意味着 Python 的 ssl 模块未正确安装或配置，导致 pip 无法通过 HTTPS 连接 PyPI（Python Package Index）。

---

问题原因 Python 编译时未启用 SSL 支持： 在编译 Python 时，如果未正确链接 OpenSSL 库，会导致 ssl 模块不可用。 系统缺少 OpenSSL 开发包： 编译 Python 需要 OpenSSL 的开发包（如 libssl-dev 或 openssl-devel），如果未安装，会导致 SSL 支持缺失。

---

解决方法 方法 1：重新编译 Python 并启用 SSL 支持

安装 OpenSSL 开发包：

对于 Ubuntu/Debian：sudo apt update sudo apt install libssl-dev 对于 CentOS/RHEL：sudo yum install openssl-devel

重新编译 Python：

下载 Python 源码：wget .python.org/ftp/python/3.10.12/Python-3.10.12.tgz tar -zxvf Python-3.10.12.tgz cd Python-3.10.12 配置并编译：./configure --enable-optimizations --with-openssl=/usr make sudo make install

验证 SSL 模块：

运行以下命令检查 ssl 模块是否可用：python3 -c "import ssl; print(ssl.OPENSSL_VERSION)" 如果输出了 OpenSSL 版本（如 OpenSSL 1.1.1），则说明 SSL 支持已启用。

---

方法 2：临时使用 HTTP 镜像源

如果无法重新编译 Python，可以通过配置 pip 使用 HTTP 镜像源来绕过 HTTPS 限制。

创建 pip 配置文件：

在用户主目录下创建 .pip 目录和 pip.conf 文件：mkdir -p ~/.pip vim ~/.pip/pip.conf

配置 HTTP 镜像源：

在 pip.conf 文件中添加以下内容：[global] index-url = http://mirrors.aliyun /pypi/simple/ [install] trusted-host = mirrors.aliyun 这里使用了阿里云的 PyPI 镜像源，您也可以选择其他镜像源（如清华源）。

使用 pip 安装包：

现在可以正常使用 pip 安装包了：pip install <package-name>

---

方法 3：修复系统 OpenSSL 环境

如果系统 OpenSSL 环境有问题（如路径错误或版本不兼容），可以尝试以下步骤：

检查 OpenSSL 版本：

运行以下命令检查 OpenSSL 版本：openssl version

修复 OpenSSL 路径：

如果 OpenSSL 安装在非标准路径（如 /usr/local/openssl），需要在编译 Python 时指定路径：./configure --with-openssl=/usr/local/openssl

更新系统 OpenSSL：

如果 OpenSSL 版本过旧，可以升级到最新版本： 对于 Ubuntu/Debian：sudo apt update sudo apt install --only-upgrade openssl 对于 CentOS/RHEL：sudo yum update openssl

---

总结 如果 Python 的 ssl 模块不可用，可以通过重新编译 Python 并启用 SSL 支持来解决问题。如果无法重新编译 Python，可以通过配置 pip 使用 HTTP 镜像源来绕过 HTTPS 限制。确保系统 OpenSSL 环境正确配置，以避免类似问题。

---

参考链接 Python 官方文档阿里云 PyPI 镜像OpenSSL 官方文档

---

希望这篇博客能帮助您解决问题！如果有其他疑问，欢迎留言讨论。