Docker容器复制本地Python环境运行代码遇ModuleNotFoundError求助

一、解决pip install超时问题 #

服务器网络慢导致pip安装超时，最直接的解决方式是使用国内PyPI镜像源，以下两种方案任选其一：

方案1：安装时直接指定镜像源 #

修改Dockerfile中的安装命令，添加镜像源参数：

RUN pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

方案2：全局配置pip镜像源（推荐） #

在Dockerfile中提前配置pip全局镜像，避免每次安装都重复指定，同时利用Docker缓存优化构建速度：

FROM python:3.10-slim
WORKDIR /app/

# 配置国内PyPI镜像源
RUN mkdir -p ~/.pip && echo "[global]\nindex-url = https://pypi.tuna.tsinghua.edu.cn/simple" > ~/.pip/pip.conf

# 优先复制requirements.txt，依赖未变更时可复用缓存层
COPY requirements.txt .
RUN pip install -r requirements.txt

# 最后复制项目代码
COPY . .
CMD ["python", "app.py"]

二、解决本地环境复制后ModuleNotFoundError问题 #

直接复制本地虚拟环境到容器的做法不可行，核心原因有两点：

1. 本地虚拟环境的依赖库是基于本地系统架构（如Windows/macOS）编译的，容器使用Linux slim镜像，架构不兼容；
2. 虚拟环境的路径是硬编码的，容器内的Python无法正确识别本地虚拟环境中的依赖位置。

替代方案：本地下载依赖包后复制到容器安装 #

如果不想在容器中联网下载依赖，可以先在本地把所有依赖包下载到本地目录，再复制到容器内安装：

1. 本地执行命令，下载依赖到packages目录：

pip download -r requirements.txt -d ./packages -i https://pypi.tuna.tsinghua.edu.cn/simple

2. 修改Dockerfile，复制本地下载的包并安装：

FROM python:3.10-slim
WORKDIR /app/

# 复制本地下载的依赖包和requirements.txt
COPY packages/ /app/packages/
COPY requirements.txt .

# 从本地包安装依赖，无需联网
RUN pip install --no-index --find-links=/app/packages -r requirements.txt

# 复制项目代码
COPY . .
CMD ["python", "app.py"]

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