CentOS7编译Python3.10.5时无法识别已存在的openssl/ssl.h

问题背景 #

在CentOS7上编译Python3.10.5时，主体编译成功但SSL模块构建失败。已手动安装OpenSSL 1.1.1c并验证安装路径为/usr/local/ssl，但执行configure时始终无法找到openssl/ssl.h，尝试指定--with-openssl为bin或include目录、修改Modules/Setup文件均无效。

解决方案 #

• 清理编译残留
  首先清理之前编译产生的缓存和文件，避免旧配置干扰：

  cd ~/Python-3.10.5
  make clean
  rm -f config.status Makefile
  

• 设置正确的环境变量
  让编译器优先找到手动安装的OpenSSL头文件和库：

  export CFLAGS="-I/usr/local/ssl/include"
  export LDFLAGS="-L/usr/local/ssl/lib"
  export LD_LIBRARY_PATH="/usr/local/ssl/lib:$LD_LIBRARY_PATH"
  

• 正确执行configure命令
  --with-openssl参数需要指向OpenSSL的安装根目录（而非bin或include子目录），同时添加--with-openssl-rpath确保运行时能找到SSL库：

  sudo ./configure --enable-optimizations --with-openssl=/usr/local/ssl --with-openssl-rpath=/usr/local/ssl/lib
  

• 修正Modules/Setup文件（可选，若configure仍有问题）
  打开~/Python-3.10.5/Modules/Setup，找到SSL相关配置块，修改为以下内容（注意OPENSSL指向根目录，而非二进制文件路径）：

  OPENSSL=/usr/local/ssl
  _ssl _ssl.c \
      -I$(OPENSSL)/include -L$(OPENSSL)/lib \
      -lssl -lcrypto
  

• 重新编译安装
  执行编译和安装命令：

  sudo make altinstall
  

• 验证SSL模块
  安装完成后，验证Python是否能正常加载SSL模块：

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

  若输出OpenSSL 1.1.1c 28 May 2019则说明成功。

关键错误点说明 #

• 之前指定--with-openssl为/usr/local/ssl/bin或/usr/local/ssl/include是错误的，configure需要的是包含include和lib子目录的根路径。
• 修改Modules/Setup时，OPENSSL变量指向了二进制文件而非根目录，导致-I$(OPENSSL)/include展开为无效路径，这是核心问题之一。

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