解决 `pip is configured with locations that require TLS/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）。

---

问题原因

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

---

解决方法

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

1. 安装 OpenSSL 开发包：

   • 对于 Ubuntu/Debian：

     sudo apt update
     sudo apt install libssl-dev
     

   • 对于 CentOS/RHEL：

     sudo yum install openssl-devel
     

2. 重新编译 Python：

   • 下载 Python 源码：

     wget https://www.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
     

3. 验证 SSL 模块：

   • 运行以下命令检查 ssl 模块是否可用：

     python3 -c "import ssl; print(ssl.OPENSSL_VERSION)"
     

   • 如果输出了 OpenSSL 版本（如 OpenSSL 1.1.1），则说明 SSL 支持已启用。

---

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

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

1. 创建 pip 配置文件：

   • 在用户主目录下创建 .pip 目录和 pip.conf 文件：

     mkdir -p ~/.pip
     vim ~/.pip/pip.conf
     

2. 配置 HTTP 镜像源：

   • 在 pip.conf 文件中添加以下内容：

     [global]
     index-url = http://mirrors.aliyun.com/pypi/simple/[install]
     trusted-host = mirrors.aliyun.com
     

   • 这里使用了阿里云的 PyPI 镜像源，您也可以选择其他镜像源（如清华源）。

3. 使用 pip 安装包：

   • 现在可以正常使用 pip 安装包了：

     pip install <package-name>
     

---

方法 3：修复系统 OpenSSL 环境

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

1. 检查 OpenSSL 版本：

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

     openssl version
     

2. 修复 OpenSSL 路径：

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

     ./configure --with-openssl=/usr/local/openssl
     

3. 更新系统 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 官方文档

---

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