Docker构建Python项目时找不到已存在版本的模块如何解决？

问题核心成因 #

1. 你当前使用的python:3.6.1-alpine镜像采用musl libc作为系统C库，而绝大多数Python官方发布的预编译包（wheel）是针对主流的glibc编译的，即使PyPI存在对应版本号的包，也没有适配musl libc的二进制版本，因此pip会报错找不到匹配的发行版。
2. Dockerfile的多阶段构建逻辑存在错误：你在builder阶段没有指定pip的安装路径为/install，依赖包默认安装到了系统/usr/local路径下，后续从builder层拷贝/install到运行层时，根本没有拷贝到实际安装的依赖包。
3. Python 3.6版本过旧，你requirements.txt中列出的多个依赖（比如Flask 2.0系列、dash 2.0系列）已经逐步停止对Python 3.6的支持，版本兼容性冲突也会导致安装失败。
4. 原ENTRYPOINT写法错误：["python3", "flask", "run"]实际是尝试执行当前目录下的flask.py文件，而非调用flask命令启动服务。

解决方案 #

1. 更换基础镜像（优先推荐） #

放弃alpine镜像，改用Debian系的slim版本Python镜像，默认自带glibc，兼容99%的Python预编译包，无需额外编译，构建速度提升非常明显。建议选择Python 3.8及以上版本，适配你列出的所有依赖版本。

2. 修正Dockerfile #

以下是可直接运行的单阶段Dockerfile示例，新手可先跳过复杂的多阶段构建，优先保证业务跑通：

# 使用Debian系Python3.8 slim镜像，体积小兼容性好
FROM python:3.8-slim

# 设置工作目录
WORKDIR /project

# 可选：安装必要的系统编译依赖，部分源码安装的包会用到
RUN apt-get update && apt-get install -y --no-install-recommends \
    gcc \
    && rm -rf /var/lib/apt/lists/*

# 升级pip到最新版本
RUN pip install --upgrade pip

# 先拷贝依赖文件，利用Docker缓存避免每次构建都重装依赖
COPY requirements.txt .
RUN pip install -r requirements.txt

# 拷贝项目全部代码
COPY . .

# 配置flask环境变量
ENV FLASK_APP=index.py
ENV FLASK_ENV=production

# 正确的启动命令
ENTRYPOINT ["flask", "run", "--host=0.0.0.0"]

3. 依赖版本适配 #

升级Python版本到3.8后，你现有requirements.txt中的所有依赖版本都可以正常安装，无需反复回退版本。

Python包与Docker环境兼容性判断方法 #

1. 查看包的PyPI页面的下载列表：如果存在对应你镜像CPU架构（比如x86_64、arm64）、且标注了manylinux的wheel包，就可以在Debian/Ubuntu系的镜像中直接安装；如果只有标注了musllinux的wheel包，才适配alpine镜像。
2. 查看包官方文档的系统要求：部分数据处理类包（比如pandas、numpy）会明确标注依赖glibc，这类包不要用alpine镜像部署。
3. 优先选择官方维护的Debian系Python基础镜像，基本可以避免90%以上的依赖安装兼容问题。

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