多阶段构建Dockerfile时出现Django导入错误的求助

问题原因 #

1. 多阶段构建依赖未传递
   你的backend阶段虽然安装了requirements.txt内的依赖，但这些依赖被安装在Python镜像的系统环境中（如/usr/local/lib/python3.10/site-packages），而非/app目录下。最终阶段仅拷贝了backend阶段的/app代码目录，并未同步已安装的依赖，导致最终镜像的Python环境是干净的，没有Django。

2. 本地卷挂载覆盖容器内容
   Docker Compose中配置的volumes: - .:/app会将本地项目目录直接挂载到容器的/app目录，完全替换容器内构建好的内容。你本地的虚拟环境在容器中无法生效（容器有独立的Python运行环境），因此容器内的Python找不到依赖包。

3. 取消注释第三阶段pip install可运行的原因
   此时会在最终容器的Python环境中重新安装所有依赖，这些依赖被安装在容器的系统Python路径下，不会被本地卷挂载覆盖，因此能正常找到Django。

解决办法 #

方案一：优化卷挂载（适合开发场景，保留代码热重载） #

不要挂载整个/app目录，仅挂载需要实时修改的代码目录，避免破坏容器内的依赖环境：
修改Docker Compose的backend服务配置：

services:
  backend:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8000:8000"
    volumes:
      # 替换为你实际的Django应用目录名和前端目录
      - ./your_django_app:/app/your_django_app
      - ./frontend:/app/frontend
    depends_on:
      - db

方案二：调整Dockerfile，传递虚拟环境依赖（适合生产/构建完整镜像） #

在backend阶段将依赖安装到项目目录内的虚拟环境，这样拷贝/app时可同步依赖到最终镜像：
修改后的Dockerfile：

FROM python:3.10.6 as backend
ENV PYTHONUNBUFFERED 1
WORKDIR /app
# 创建项目内的虚拟环境
RUN python -m venv ./venv
# 激活虚拟环境
ENV PATH="/app/venv/bin:$PATH"
COPY requirements.txt ./requirements.txt
RUN pip install -r requirements.txt
COPY . .

FROM node:18-alpine as frontend
WORKDIR /app/frontend
COPY frontend/package.json ./package.json
COPY frontend/package-lock.json ./package-lock.json
RUN npm install
COPY frontend .
RUN npm run build

FROM python:3.10.6
WORKDIR /app
# 拷贝虚拟环境和代码
COPY --from=backend /app/venv ./venv
COPY --from=backend /app .
ENV PATH="/app/venv/bin:$PATH"
COPY --from=frontend /app/frontend ./frontend
CMD python3 manage.py runserver 0.0.0.0:8000

方案三：移除卷挂载（适合生产环境） #

如果不需要本地代码热重载，直接删除Docker Compose中backend服务的volumes配置，容器将使用构建镜像时的代码和依赖，避免本地目录覆盖容器内容。

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