Docker镜像中pip安装Python包失败：celery-app无法导入core包求助

核心问题 #

你遇到的ModuleNotFoundError主要源于两个关键疏漏：

1. core镜像未完成包安装：core的Dockerfile仅执行了python -m build生成了包文件（存于/core/dist），但并未将core包安装到镜像的Python全局环境中。
2. celery-app的包安装逻辑存在隐患：虽然celery-app基于core镜像构建，容器内确实存在/core目录，但pip3 install ../core/的写法依赖于当前WORKDIR的上级路径，且未明确使用core已构建好的包文件，容易因包配置缺失或路径解析问题导致安装不生效。

可行的修复方案 #

方案一：在core镜像中直接完成包安装（推荐） #

修改core的Dockerfile，在构建包后添加安装步骤，确保core包被预装到镜像的Python环境中：

# core Dockerfile
FROM alpine:3.15

RUN apk update
RUN apk add python3 py3-setuptools py3-pip python3-dev gcc curl-dev libcurl libc-dev
RUN if [ ! -e /usr/bin/python ]; then ln -sf python3 /usr/bin/python; fi

WORKDIR /core
RUN pip3 install --upgrade pip setuptools wheel
COPY . . 
RUN pip3 install -r requirements.txt --ignore-installed

# Build as a package
RUN pip3 install --upgrade build
RUN python3 -m build --no-isolation
# 安装构建好的core包到Python环境
RUN pip3 install dist/*.whl

此时celery-app的Dockerfile无需再手动安装core，直接基于此镜像构建即可：

# celery-app Dockerfile
FROM massworker-core:latest

WORKDIR /celery_app
RUN pip3 install --upgrade pip

COPY . .
RUN pip3 install -r requirements.txt

方案二：在celery-app中正确安装core包 #

如果需要在celery-app阶段安装core，建议直接使用core镜像中已构建好的包文件，避免源码安装的潜在问题：

# celery-app Dockerfile
FROM massworker-core:latest

WORKDIR /celery_app
RUN pip3 install --upgrade pip
# 使用core镜像中已构建的包文件安装
RUN pip3 install /core/dist/*.whl --ignore-installed

COPY . .
RUN pip3 install -r requirements.txt

可行性说明 #

这种基于基础镜像共享依赖包的实现方式是完全可行的，本质是利用Docker镜像的分层特性，将core包的构建与安装逻辑复用给celery-app。只要确保core包的配置文件（setup.py/pyproject.toml/setup.cfg）存在且正确，就能保证包被Python环境识别。

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