基于CentOS7的Docker镜像编译安装Python3.12.3失败求助

问题重现 #

在CentOS7的Docker镜像中源码编译Python3.12.3，使用的Dockerfile如下：

FROM centos:7

# Set bash as the default shell
SHELL ["/bin/bash", "-c"]
RUN yum -y update
RUN yum install -y openssl-devel bzip2-devel libffi-devel zlib-devel gcc wget epel-release.noarch openssl11-devel
RUN yum groupinstall -y "Development Tools"
# RUN set -x \
#    localedef -i en_US -f UTF-8 en_US.UTF-8 \
RUN wget https://www.python.org/ftp/python/3.12.3/Python-3.12.3.tgz \
   && tar -xzf Python-3.12.3.tgz\
   && cd Python-3.12.3\
   &&  sed -i 's/PKG_CONFIG openssl /PKG_CONFIG openssl11 /g' configure\
   && ./configure --enable-optimizations \
   && make altinstall

编译阶段最终报错：

#0 650.1        Programs/_bootstrap_python.o Modules/getpath.o -lpthread -ldl  -lutil                        -lm
#0 650.7 ./_bootstrap_python ./Programs/_freeze_module.py abc ./Lib/abc.py Python/frozen_modules/abc.h
#0 650.8 Fatal Python error: init_import_site: Failed to import the site module
#0 650.8 Python runtime state: initialized
#0 650.8 Traceback (most recent call last):
#0 650.8   File "/Python-3.12.3/Lib/site.py", line 73, in <module>
#0 650.8     import os
#0 650.8   File "/Python-3.12.3/Lib/os.py", line 29, in <module>
#0 650.8     from _collections_abc import _check_methods
#0 650.8 SystemError: <built-in function compile> returned NULL without setting an exception
#0 650.8 make[1]: *** [Python/frozen_modules/abc.h] Error 1
#0 650.8 make[1]: Leaving directory `/Python-3.12.3'
#0 650.8 make: *** [profile-opt] Error 2

出错原因 #

1. gcc版本不兼容：CentOS7默认gcc版本为4.8.5，而Python3.12的--enable-optimizations选项依赖PGO（Profile-Guided Optimization）特性，老版本gcc无法正确处理该优化流程，导致bootstrap阶段的Python解释器运行出错。
2. openssl配置存在遗漏：仅修改configure文件的PKG_CONFIG指向openssl11，仍可能出现编译时无法正确找到openssl11头文件和库文件的问题。

解决步骤 #

1. 移除--enable-optimizations选项 #

直接去掉该优化选项，规避老gcc的兼容性问题。若确实需要编译优化，可后续手动升级gcc至9+版本，但会增加镜像构建复杂度。

2. 明确指定openssl11路径 #

在configure阶段通过--with-openssl参数直接指定openssl11的安装路径，CentOS7中openssl11的默认路径为/usr/lib64/openssl11/和/usr/include/openssl11/。

3. 优化Dockerfile层级（可选） #

合并多个RUN指令减少镜像层数，编译完成后清理源码包和临时文件，缩小镜像体积。

修改后的Dockerfile #

FROM centos:7

SHELL ["/bin/bash", "-c"]

# 安装依赖并编译Python
RUN yum -y update && \
    yum install -y openssl-devel bzip2-devel libffi-devel zlib-devel gcc wget epel-release.noarch openssl11-devel && \
    yum groupinstall -y "Development Tools" && \
    # 下载并解压Python源码
    wget https://www.python.org/ftp/python/3.12.3/Python-3.12.3.tgz && \
    tar -xzf Python-3.12.3.tgz && \
    cd Python-3.12.3 && \
    # 配置编译参数，指定openssl11路径，移除优化选项
    ./configure --prefix=/usr/local/python3.12 --with-openssl=/usr/lib64/openssl11 --with-openssl-rpath=auto && \
    make altinstall && \
    # 清理临时文件
    cd / && \
    rm -rf Python-3.12.3* && \
    yum clean all

验证 #

构建镜像后，进入容器执行python3.12 -V，应能正常显示版本号；执行python3.12进入交互模式无报错。

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