Docker多阶段构建运行容器时出现ModuleNotFoundError问题排查

核心问题 #

1. 构建阶段引用错误：你的Dockerfile第一个阶段既没有指定基础镜像，也没有通过AS compile-image命名，导致后续COPY --from=compile-image无法找到该阶段，虚拟环境根本没被复制到最终镜像中，自然找不到pandas。
2. libc兼容性问题：即便解决阶段引用问题，用Debian/Ubuntu类镜像（基于glibc）构建的虚拟环境，直接复制到Alpine镜像（基于musl libc）中，会因底层C库不兼容，导致pandas这类带C扩展的包无法运行。

修正后的Dockerfile #

# 第一阶段：编译依赖（使用Alpine镜像保证libc兼容）
FROM python:3-alpine3.18 AS compile-image

WORKDIR /opt/fwr

# 安装编译pandas等包所需的依赖
RUN apk add --no-cache gcc musl-dev python3-dev

# 创建并激活虚拟环境
RUN python3 -m venv /opt/fwr/venv
ENV PATH="/opt/fwr/venv/bin:$PATH"

# 复制依赖文件并安装
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 第二阶段：构建轻量最终镜像
FROM python:3-alpine3.18

WORKDIR /opt/fwr

# 从编译阶段复制已安装好依赖的虚拟环境
COPY --from=compile-image /opt/fwr/venv /opt/fwr/venv

# 复制应用代码
COPY *.py ./

# 设置环境变量激活虚拟环境
ENV PATH="/opt/fwr/venv/bin:$PATH"

# 启动命令
ENTRYPOINT ["python"]
CMD ["-u", "main.py"]

关键修改说明 #

• 第一阶段明确指定Alpine基础镜像并命名为compile-image，确保后续能正确引用该阶段的内容。
• 在编译阶段补充安装Alpine下编译Python扩展包所需的工具（如gcc），因为pandas包含C扩展，必须在对应libc环境下编译才能正常运行。
• 虚拟环境路径独立清晰，避免与工作目录混淆，确保复制后的环境完整性。

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