树莓派4编译安装Python3.11后pip缺失SSL模块问题排查

问题背景 #

在无头树莓派4上源码编译Python 3.11.1后，pip无法使用，报错：

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

使用的安装脚本已包含常见依赖，但问题仍未解决。

安装脚本 #

#!/bin/bash

if [ true ]; then
  # get a current python3
  
  sudo apt-get install wget build-essential libreadline-gplv2-dev libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev zlib1g-dev liblzma-dev -y
  VERSION=3.11.1
  VERSION_SHORT=3.11
  
  mkdir -p tmp
  cd tmp
  
  if [ ! -f Python-${VERSION}.tgz ]; then
    wget -O Python-${VERSION}.tgz https://www.python.org/ftp/python/${VERSION}/Python-${VERSION}.tgz
  fi
  
  tar xzf Python-${VERSION}.tgz
  cd Python-${VERSION}
  if [ ! -f python ]; then
    ./configure --enable-optimizations
  fi
  echo "### make altinstall"
  sudo make altinstall
  sudo update-alternatives --install /usr/bin/python python /usr/local/bin/python${VERSION_SHORT} 1
  
  echo "### install pip"
  /usr/local/bin/python${VERSION_SHORT} -m pip install --upgrade pip
  sudo update-alternatives --install /usr/bin/pip pip /usr/local/bin/pip${VERSION_SHORT} 1
  
  cd ..
fi

解决方案 #

1. 重新安装SSL依赖并确认路径 #

树莓派上有时会出现SSL库链接异常，先重装依赖：

sudo apt-get update && sudo apt-get install --reinstall openssl libssl-dev

然后确认SSL库路径：

find / -name libssl.so

通常路径是/usr/lib/ssl/libssl.so或/usr/lib/aarch64-linux-gnu/libssl.so（根据树莓派架构调整）。

2. 清理编译缓存并重新编译Python #

之前的编译可能因为缓存导致SSL模块未被正确编译，按以下步骤操作：

# 进入Python源码目录
cd tmp/Python-3.11.1
# 清理旧编译文件
sudo make clean
# 配置编译参数，手动指定SSL路径
./configure --enable-optimizations --with-openssl=/usr/lib/ssl
# 重新编译安装
sudo make altinstall

3. 验证SSL模块是否正常 #

编译完成后，执行以下命令检查：

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

如果能正常输出OpenSSL版本，说明SSL模块已正确安装，此时pip即可正常使用。

关于“无需pip安装SSL模块”的说明 #

Python的SSL模块是核心内置模块，无法单独通过pip或其他方式安装，必须在编译Python时确保链接到系统的SSL库才能启用。因此重新编译是唯一可行的解决途径。

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