ReactJS/NestJS单体项目Docker化问题：文件结构与Compose不匹配

核心问题分析 #

你在多阶段构建中预设的build、install、prune目录在容器中找不到，大概率是以下原因：

• 多阶段构建的最终镜像未复制前面阶段的目录
• 各阶段的WORKDIR或COPY路径配置错误
• Docker Compose 的卷挂载覆盖了镜像中的目标目录

修正后的多阶段 Dockerfile.back 示例 #

# 安装依赖阶段
FROM node:20-alpine AS install
WORKDIR /app/install
# 复制根目录的依赖配置
COPY package.json pnpm-lock.yaml ./
# 安装全量依赖
RUN pnpm install --frozen-lockfile

# 构建阶段
FROM install AS build
WORKDIR /app/build
# 复制安装好的依赖
COPY --from=install /app/install/node_modules ./node_modules
# 复制后端代码、共享包及配置文件
COPY apps/back ./apps/back
COPY packages ./packages
COPY tsconfig.json nx.json ./
# 执行构建命令
RUN pnpm run build:back

# 修剪生产依赖阶段
FROM install AS prune
WORKDIR /app/prune
# 复制构建产物
COPY --from=build /app/build/apps/back/dist ./dist
# 复制依赖配置
COPY package.json pnpm-lock.yaml ./
# 仅安装生产依赖
RUN pnpm install --prod --frozen-lockfile

# 最终运行阶段
FROM node:20-alpine AS runtime
WORKDIR /app
# 复制所有调试用阶段目录到最终镜像
COPY --from=install /app/install /app/install
COPY --from=build /app/build /app/build
COPY --from=prune /app/prune /app/prune
# 启动后端服务（基于修剪后的生产依赖）
CMD ["node", "/app/prune/dist/main"]

Docker Compose 配置注意事项 #

确保compose.yaml中没有覆盖/app目录的卷挂载（调试时可挂载子目录，避免覆盖预设文件夹）：

services:
  back:
    build:
      context: .
      dockerfile: Dockerfile.back
    # 调试时挂载代码子目录，不要挂载/app根目录
    volumes:
      - ./apps/back:/app/build/apps/back
      - ./packages:/app/build/packages
    ports:
      - "3000:3000"

排查与调试步骤 #

• 单独验证构建阶段：运行docker build --target install -t back-install .构建安装阶段镜像，再用docker run -it back-install sh进入容器，检查/app/install目录内容是否正常
• 查看构建日志：执行docker compose build --no-cache重新构建，观察日志中COPY、RUN命令是否有报错
• 检查最终容器目录：进入容器后执行ls /app，确认install、build、prune目录是否存在
• 清理缓存：如果之前有旧镜像缓存，执行docker system prune -af清空后重新构建

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