Debian 11中Python编译安装SSL模块缺失致pip无法使用的解决问询

• 在Debian 11中手动编译安装Python 3.11.5后，使用pip3.11安装包时出现警告：pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available，无法完成下载。
• 执行的编译命令：

cd Python 3.11.5
./configure --prefix=/usr/local --enable-optimizations --enable-shared LDFLAGS="-Wl,-rpath /usr/local/lib"
sudo make
sudo make altinstall

• make过程中的关键报错：

*** WARNING: renaming "_crypt" since importing it failed: libcrypt.so.2: cannot open shared object file: No such file or directory

The necessary bits to build these optional modules were not found:
_hashlib _ssl _tkinter
To find the necessary bits, look in setup.py in detect_modules() for the module's name.

The following modules built successfully but were removed because they could not be imported:
_crypt

Could not build the SSL module!
Python requires an OpenSSL 1.1.1 or newer

• 已尝试的操作：
  • 安装openssl并尝试通过--with-openssl指定路径（包括brew安装和手动编译到/usr/local/bin/openssl的版本）
  • 使用pyenv安装Python 3.10，同样报错ModuleNotFoundError: No module named '_ssl'；pyenv显示安装成功，但~/.pyenv/versions/目录为空，无法识别新安装版本
  • 按照pyenv相关指南设置CPPFLAGS和LDFLAGS后重新安装，问题依旧

1. 安装Python编译必需的依赖库 #

Debian系统编译Python需要完整的开发依赖，尤其是SSL和crypt相关的开发包，执行以下命令：

sudo apt update
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libsqlite3-dev wget libbz2-dev libcrypt-dev

其中libcrypt-dev用于解决libcrypt.so.2缺失问题，libssl-dev是编译SSL模块的核心依赖。

2. 清理编译残留 #

手动编译Python的清理 #

进入Python源码目录，彻底清理之前的编译残留：

cd Python 3.11.5
sudo make clean
sudo make distclean

pyenv的清理 #

删除pyenv的安装缓存和可能的残留版本目录：

rm -rf ~/.pyenv/cache/*
rm -rf ~/.pyenv/versions/3.10.12  # 如果存在该残留目录

3. 重新手动编译Python（指定SSL路径） #

优先使用系统标准路径的openssl，如果已将openssl编译到/usr/local，使用以下配置命令让Python正确识别头文件和库：

./configure --prefix=/usr/local --enable-optimizations --enable-shared \
LDFLAGS="-Wl,-rpath /usr/local/lib -L/usr/local/lib" \
CPPFLAGS="-I/usr/local/include" \
--with-openssl=/usr/local

随后重新编译安装：

sudo make -j$(nproc)  # 多线程加速编译
sudo make altinstall

编译完成后验证SSL模块是否正常：

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

若能输出openssl版本号，说明模块编译成功。

4. 修复pyenv安装问题 #

确保已安装步骤1的所有依赖，设置环境变量指向正确的openssl路径后重新安装：

export CPPFLAGS="-I/usr/local/include"
export LDFLAGS="-L/usr/local/lib"
export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig"
pyenv install -v 3.11.5  # 可通过`pyenv install --list`查看支持的版本

安装完成后，验证版本和SSL模块：

pyenv versions
pyenv global 3.11.5
python -c "import ssl; print(ssl.OPENSSL_VERSION)"

5. 排查openssl路径有效性 #

如果仍无法识别openssl，检查头文件和库文件是否存在：

# 检查openssl头文件
ls /usr/local/include/openssl/ssl.h
# 检查openssl库文件
ls /usr/local/lib/libssl.so /usr/local/lib/libcrypto.so

若文件不存在，重新编译安装openssl到/usr/local：

wget https://www.openssl.org/source/openssl-1.1.1w.tar.gz  # Python3.11支持1.1.1系列或3.x版本
tar xzf openssl-1.1.1w.tar.gz
cd openssl-1.1.1w
./config --prefix=/usr/local --openssldir=/usr/local/ssl shared zlib-dynamic
make -j$(nproc)
sudo make install
sudo ldconfig  # 更新系统库缓存

完成后再重新编译Python或使用pyenv安装。

内容的提问来源于stack exchange，提问作者juanmac