Docker化NestJS Monorepo（含Prisma）构建后容器重启故障排查

问题背景 #

项目为包含两个应用的NestJS Monorepo，使用Prisma ORM连接MySQL，Prisma Schema放置在项目根目录。Docker化后app1、app2容器持续重启，核心报错：

2025-06-01 07:42:50  ERR_PNPM_NO_IMPORTER_MANIFEST_FOUND  No package.json (or package.yaml, or package.json5) was found in "/usr/src/app".

项目结构：

monorepo/
├── apps/
│   ├── app1/
│   │   ├── src/
│   │   ├── Dockerfile
│   │   └── ...
│   ├── app2/
│   │   ├── src/
│   │   ├── Dockerfile
│   │   └── ...
├── prisma/
│   ├── schema.prisma
│   └── migrations/
├── libs/
│   └── common/
├── docker-compose.yaml
├── package.json
└── ...

核心原因 #

Docker Compose中挂载volume时，将./apps/app1直接覆盖容器内的/usr/src/app目录，导致项目根目录的package.json、prisma等关键文件被替换，pnpm执行命令时无法找到包管理配置文件。

解决方案 #

1. 调整Docker Compose Volume配置 #

修改docker-compose.yaml中app1、app2的volume挂载规则，仅同步源码目录而非覆盖根目录：

services:
  # db服务配置保持不变

  app1:
    build:
      context: .
      dockerfile: ./apps/app1/Dockerfile
      target: development
    command: pnpm run start:dev:app1
    env_file:
      - .env          # 加载根目录全局环境变量
      - ./apps/app1/.env  # 加载应用专属环境变量
    ports:
      - '3000:3000'
    depends_on:
      db:
        condition: service_healthy
    restart: always
    networks:
      - my_network
    volumes:
      - ./apps/app1:/usr/src/app/apps/app1  # 仅同步app1源码到容器对应路径
      - ./prisma:/usr/src/app/prisma        # 同步Prisma schema目录
      - /usr/src/app/node_modules           # 保留容器内依赖，避免本地冲突

  app2:
    build:
      context: .
      dockerfile: ./apps/app2/Dockerfile
      target: development
    command: pnpm run start:dev:app2
    env_file:
      - .env
      - ./apps/app2/.env
    ports:
      - '3001:3001'
    depends_on:
      db:
        condition: service_healthy
    restart: always
    networks:
      - my_network
    volumes:
      - ./apps/app2:/usr/src/app/apps/app2
      - ./prisma:/usr/src/app/prisma
      - /usr/src/app/node_modules

# volumes、networks配置保持不变

2. 优化package.json启动脚本 #

在根目录package.json中添加针对单个应用的开发启动命令：

"scripts": {
  "build": "nest build",
  "format": "prettier --write \"apps/**/*.ts\" \"libs/**/*.ts\"",
  "start:dev:app1": "nest start app1 --watch",  // 指定启动app1并开启热重载
  "start:dev:app2": "nest start app2 --watch",  // 指定启动app2并开启热重载
  "start:debug:app1": "nest start app1 --debug --watch",
  "start:debug:app2": "nest start app2 --debug --watch",
  "start:prod:app1": "node dist/apps/app1/main",
  "start:prod:app2": "node dist/apps/app2/main",
  "migrate": "pnpm prisma migrate dev",
  // 其他原有脚本保持不变
}

3. 修正Dockerfile生产阶段配置 #

每个应用的Dockerfile需调整生产阶段的启动路径，以app2为例：

# ----- Production Stage -----
FROM node:alpine AS production

ARG NODE_ENV=production
ENV NODE_ENV=${NODE_ENV}

WORKDIR /usr/src/app

COPY package*.json ./
COPY pnpm-lock.yaml ./
COPY prisma ./prisma

RUN npm install -g pnpm
RUN pnpm install --prod
RUN pnpm prisma generate

COPY --from=development /usr/src/app/dist ./dist

# 改为app2的启动文件路径
CMD ["node", "dist/apps/app2/main"]

4. 环境变量加载规则 #

• 根目录.env存放全局配置（如DATABASE_URL="mysql://user:password@db:3306/db_name"）
• 应用内.env存放专属配置（如端口、应用特定参数）
• Docker Compose通过多env_file配置实现双重加载，应用内变量会覆盖根目录同名变量

验证步骤 #

1. 停止所有容器：docker-compose down
2. 重新构建并启动：docker-compose up -d --build
3. 查看应用日志：docker-compose logs -f app1 app2，确认无报错且服务启动成功
4. 测试API可用性：访问http://localhost:3000和http://localhost:3001验证服务响应
5. 测试数据库连接：通过应用接口触发数据库操作，确认Prisma可正常访问MySQL

内容的提问来源于stack exchange，提问作者M.G.S SUPUNTHAKA