Docker部署Django REST应用时Python3镜像错误安装Python2如何解决

你当前使用的python:3为官方Python基础镜像，本身默认自带Python3运行环境，出现安装Python2的情况可通过以下方案逐一排查解决： #

1. 固定精确的镜像版本标签 #

• python:3属于浮动标签，拉取时可能匹配到本地缓存的被污染的同名镜像，也可能因镜像源同步问题拿到不符合预期的镜像。建议替换为明确的版本号，可根据项目适配情况选择带slim后缀的精简镜像，示例：

# 比如适配Python3.10就写对应精确版本，避免浮动标签歧义
FROM python:3.10.12-slim

• 构建镜像时添加--no-cache参数，强制拉取远程最新镜像，跳过本地缓存：

docker build --no-cache -t django-rest-app .

2. 显式指定Python3调用路径，避免别名混淆 #

大部分情况下并非没有安装Python3，而是系统默认python、pip命令指向了Python2版本，可在Dockerfile中显式设置别名，所有命令优先调用Python3：

# 放在FROM指令之后，其余指令之前
RUN ln -sf /usr/bin/python3 /usr/bin/python && ln -sf /usr/bin/pip3 /usr/bin/pip
# 后续pip操作统一显式用python3调用，避免歧义
RUN python3 -m pip install --upgrade pip
RUN python3 -m pip install -r requirements.txt

• 构建过程中可添加版本校验指令排查，确认当前镜像的Python版本是否符合要求：

RUN python3 --version

3. 排查镜像源与依赖问题 #

• 如果你使用了第三方Docker镜像源，部分非官方维护的镜像可能修改了官方Python镜像的内容，默认携带Python2甚至修改了默认Python指向，可临时切换为官方源构建验证，确认问题后更换合规的镜像源即可。
• 注释掉requirements.txt安装步骤重新构建镜像，进入容器确认Python版本，如果此时版本正常，说明是项目依赖包安装过程中连带安装了Python2、修改了系统默认Python指向，逐一排查依赖包的版本适配即可。

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