在安装 Django 时遇到 SSL 模块缺失的问题，通常与 Python 编译时所使用的 OpenSSL 版本有关。如果系统中使用的 Python 是通过源码编译安装的，则可能没有正确链接到支持 TLS/SSL 的 OpenSSL 库。 ### 原因分析 - **OpenSSL 版本过低**：Python 在编译过程中依赖系统的 OpenSSL 库，如果该库版本低于 1.1.1，则可能导致 `ssl` 模块无法正常工作 [^1]。 - **缺少必要的开发包**：在 Linux 系统上，如果没有安装 `libssl-dev` 或类似开发包，则编译 Python 时将不会包含 SSL 支持 [^4]。 - **环境配置错误**：有时即使 OpenSSL 已安装，但由于路径配置不正确或使用了虚拟环境中的 Python 解释器，也可能导致 SSL 模块不可用 [^2]。 ### 解决方法 #### 方法一：重新编译 Python 并指定 OpenSSL 路径 1. 安装必要的依赖包（以 Ubuntu/Debian 为例）： ```bash sudo apt-get install build-essential libssl-dev zlib1g-dev \ libbz2-dev libreadline-dev libsqlite3-dev \ wget curl llvm libncurses5-dev xz-utils tk-dev \ libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev ``` 2. 下载并解压 Python 源码包（例如 Python 3.10）： ```bash wget https://www.python.org/ftp/python/3.10.13/Python-3.10.13.tgz tar -xzf Python-3.10.13.tgz cd Python-3.10.13 ``` 3. 配置编译参数，并指定 OpenSSL 安装路径（确保系统中已安装较新版本的 OpenSSL）： ```bash ./configure --enable-optimizations --with-openssl=/usr/local/ssl ``` 4. 编译并安装： ```bash make -j$(nproc) sudo make altinstall ``` 5. 验证是否成功启用 SSL 模块： ```bash python3.10 -c "import ssl; print(ssl.OPENSSL_VERSION)" ``` #### 方法二：更新系统 OpenSSL 并重建 Python 如果你使用的是系统自带的 Python，可以尝试升级系统的 OpenSSL 到 1.1.1 或更高版本，并重新安装 Python 包： ```bash sudo apt update sudo apt upgrade openssl sudo apt reinstall python3 ``` #### 方法三：使用预编译版本（适用于 Windows/macOS） 对于 Windows 或 macOS 用户，建议使用官方提供的 Python 安装程序，它们通常已经集成了完整的 SSL 支持。也可以考虑使用 [pyenv](https://github.com/pyenv/pyenv) 来管理 Python 版本，它能自动处理 OpenSSL 依赖问题。 #### 方法四：临时禁用 HTTPS（不推荐） 如果仅是测试用途，可以通过修改 pip 配置来禁用 HTTPS： ```ini [global] trusted-host = files.pythonhosted.org trusted-host = pypi.org trusted-host = files.pythonhosted.org trusted-host = *.pypi.org trusted-host = *.files.pythonhosted.org disable-pip-version-check = true ``` 但这种方式存在安全风险，不应在生产环境中使用。 --- ###