Docker容器Python版本未按Dockerfile指定变更（指定3.7实际为3.8）

核心原因分析 #

1. 构建参数不匹配：构建命令传入的python参数仅为3.7，而非Dockerfile预期的3.7.11，导致安装的是Ubuntu 18.04仓库默认的Python 3.7分支版本；更关键的是——
2. 宿主目录挂载干扰：运行容器时通过-v "/nfs/home/$u:/home/$u"将宿主用户home目录挂载到容器内，宿主home的.local/bin或bin目录中存在Python 3.8可执行文件，且容器PATH环境变量中/home/$USER_NAME/.local/bin和/home/$USER_NAME/bin优先级高于系统默认的/usr/bin，执行python时会优先调用宿主的Python 3.8。

分步解决方案 #

1. 修正构建参数，确保安装指定Python版本 #

修改构建脚本中的PYTHON_VERSION为完整版本号：

PYTHON_VERSION=3.7.11

同时，Ubuntu 18.04默认仓库没有Python 3.7.11的包，需在Dockerfile中添加软件源，在RUN rm /etc/apt/sources.list.d/nvidia-ml.list之后插入：

# 添加deadsnakes源以获取指定Python版本
RUN apt-get update && apt-get install -y software-properties-common && \
    add-apt-repository ppa:deadsnakes/ppa && \
    apt-get update

2. 消除宿主挂载的版本干扰 #

方案A：调整PATH优先级

修改Dockerfile的PATH设置，让系统路径优先：

ENV PATH=/usr/bin:/home/$USER_NAME/.local/bin:$PATH
ENV PATH=/usr/bin:/home/$USER_NAME/bin:$PATH

方案B：移除不必要的宿主home挂载

若无需共享宿主home目录，删除运行命令中的：

-v "/nfs/home/$u:/home/$u"

方案C：直接调用系统级Python

进入容器时明确指定系统路径的Python：

docker run ... -it $DOCKER_IMAGE /bin/bash -c "exec /usr/bin/python"

3. 确保软链接配置正确 #

完善Dockerfile中的软链接命令：

RUN rm -f /usr/bin/python /usr/bin/python3
RUN ln -sf /usr/bin/python${PYTHON_VERSION} /usr/bin/python
RUN ln -sf /usr/bin/python${PYTHON_VERSION} /usr/bin/python3

可在Dockerfile末尾加验证步骤，方便构建时排查：

RUN python --version && python3 --version

验证步骤 #

1. 执行修改后的构建脚本重新构建镜像
2. 临时移除宿主home挂载，验证系统Python版本：

docker run --gpus all --rm --ipc=host \
    -e HOSTNAME=${hostname} \
    -e ROOT_DIR=${root_dir} \
    -e DISPLAY\
    -u $u:$g \
    -v "/nfs:/nfs/" \
    -v "/tmp/.X11-unix:/tmp/.X11-unix:rw" \
    -it $DOCKER_IMAGE python --version

若输出Python 3.7.11，说明系统安装正确，问题根源是宿主挂载干扰。

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