Docker构建Python项目镜像时pip安装requirements依赖版本不匹配报错

• Dockerfile存在语法错误：CMD pip --version 属于容器启动时执行的指令，不会在镜像构建阶段运行，导致你之前执行的pip升级操作没有生效，实际构建依赖时使用的仍然是Alpine 3.9自带的旧版本pip，旧版本pip无法正确识别部分Python包的发行版格式，才会出现明明版本列表里有对应版本，却提示找不到匹配分发的错误。
• Alpine镜像使用musl libc而非常规Linux发行版的glibc，大部分Python包的预编译wheel包是针对glibc构建的，没有对应musl的预编译包时需要本地编译，而Alpine 3.9默认缺少C编译、依赖库头等编译必备组件，也会导致依赖安装失败。
• Alpine 3.9自带的Python版本为3.6，你依赖列表中部分包（如Flask 2.0、Werkzeug 2.0等）对Python版本有更高要求，版本不匹配也会触发安装报错。

方案一：保留Alpine镜像，修改Dockerfile适配 #

修改后的Dockerfile内容如下：

# 建议升级Alpine版本到3.13+，匹配更高Python版本适配你的依赖
FROM python:alpine3.15

WORKDIR /app

ADD . /app

# 先安装系统编译依赖
RUN apk add --no-cache gcc musl-dev python3-dev libffi-dev openssl-dev

# 升级pip
RUN python -m pip install --upgrade pip
# 把原CMD改成RUN，构建阶段验证pip版本
RUN pip --version

RUN pip install -r requirements.txt

# 最后补充你自己的容器启动命令，比如你的Flask启动指令
# CMD ["python", "app.py"]

方案二：换用Debian系基础镜像（更推荐，无需编译，安装速度更快，兼容性更好） #

直接使用带glibc的Python slim镜像，不需要额外安装编译依赖，修改后的Dockerfile如下：

FROM python:3.9-slim

WORKDIR /app

ADD . /app

RUN python -m pip install --upgrade pip
RUN pip --version

RUN pip install -r requirements.txt

# 补充你的启动命令
# CMD ["python", "app.py"]

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