Docker构建Django+React(Vite)应用时pip安装依赖失败求助

核心问题分析 #

你遇到的pip install -r requirements.txt执行失败（exit code 1），根本原因是Django的Dockerfile执行顺序错误：在执行pip install时，本地项目文件（包括requirements.txt）还没复制到容器中，pip找不到依赖清单文件，导致安装失败。

同时当前的Dockerfile没有利用Docker缓存机制，每次修改代码都会重新安装所有依赖，构建效率极低，还可能引入不必要的镜像体积冗余。

修正后的Docker配置 #

Django后端Dockerfile

FROM python:3.10-slim

ENV PYTHONUNBUFFERED=1
ENV EMAIL_HOST_USER=email
ENV EMAIL_HOST_PASSWORD=password

WORKDIR /backend

# 优先复制依赖清单，复用Docker缓存
COPY requirements.txt .

# 安装系统依赖、升级pip并安装Python依赖，同时清理冗余文件减小镜像体积
RUN apt-get update && apt-get install -y --no-install-recommends libpq-dev build-essential \
    && pip install --upgrade pip \
    && pip install -r requirements.txt \
    && apt-get purge -y --auto-remove build-essential \
    && rm -rf /var/lib/apt/lists/*

# 最后复制整个项目代码
COPY . . 

EXPOSE 8000

React前端Dockerfile（附带缓存优化）

FROM node:20.6-buster-slim

WORKDIR /frontend

# 优先复制依赖配置文件，复用缓存
COPY package*.json ./

RUN npm install

# 复制项目代码
COPY . .

EXPOSE 5173

CMD ["npm", "run", "dev"]

docker-compose.yml（保持原结构，无需修改）

services:
  backend:
    build: ./backend        
    ports:
      - "8000:8000"
    volumes:
      - ./backend:/backend
    command: bash -c "python manage.py makemigrations && python manage.py migrate && python manage.py runserver 0.0.0.0:8000"

  frontend:
    build: ./frontend
    ports:
      - "5173:5173"
    volumes:
      - ./frontend:/frontend

关键修改说明 #

1. 调整文件复制顺序：先复制requirements.txt/package*.json再安装依赖，这样只有当依赖清单变化时，Docker才会重新执行安装步骤，大幅提升构建速度。
2. 优化镜像体积：通过--no-install-recommends避免安装不必要的系统依赖，安装完成后清理apt缓存和编译依赖（build-essential），减小最终镜像大小。
3. 升级pip：避免旧版本pip在安装某些新型依赖时出现兼容性问题。

验证步骤 #

1. 将修改后的Dockerfile替换到对应目录
2. 执行首次构建（强制清除缓存确保生效）：

   docker-compose build --no-cache
   

3. 启动服务：

   docker-compose up
   

额外排查点 #

• 确认本地backend目录下确实存在requirements.txt，且文件内没有语法错误
• 如果依赖中包含需要编译的包（如psycopg2），确保系统依赖（如libpq-dev）已正确安装

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