Docker运行NestJS项目时无法解析模块问题求助

问题背景 #

本地直接运行npm run start:dev一切正常，但通过Docker dev阶段启动服务时，src目录下的文件无法解析任何模块（如@nestjs/common），报错表现与缺少node_modules时一致。

配置文件 #

Dockerfile #

# syntax:docker/dockerfile:1

#base
FROM node:16.14.2-alpine AS base

ENV NODE_ENV=production

WORKDIR /app

RUN npm i -g npm@8.19.3 @nestjs/cli

COPY ["./package.json", "./"]

#dev
FROM base AS dev

RUN npm i
COPY . .

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

#prod
FROM base AS prod

COPY . .

RUN npm i --frozen-lockfile --production

CMD ["npm", "run", "start:prod"]

docker-compose.yml #

version: '3.9'

services:

  backend:
    build:
      context: ./back 
      target: dev
    env_file:
      - ./env/back.env
    ports:
      - 2000:2000
    volumes:
      - ./back:/app
    networks:
      - backend
    depends_on:
      - database
    restart: unless-stopped

  database:
    image: postgres:latest
    restart: unless-stopped
    ports:
      - 5432:5432
    environment:
      POSTGRES_USER: transcendeur
      POSTGRES_PASSWORD: bigData
      POSTGRES_DB: transcendb
    networks:
      - backend
    volumes:
      - postgres:/var/lib/postgresql/data

  databaseadmin:
    image: dpage/pgadmin4:latest
    restart: unless-stopped
    ports:
      - 5050:80
    env_file:
      - ./env/pgadmin.env
    environment:
      PGADMIN_DEFAULT_EMAIL: nidma@nidma.com
      PGADMIN_DEFAULT_PASSWORD: dimnagp4
    networks:
      - backend
    volumes:
      - ./docker/pgadmin_servers.json:/pgadmin4/servers.json
    depends_on:
      - database
    logging:
      driver: none

volumes:
  postgres:
  back:

networks:
  backend:
    driver: bridge

package.json #

{
  "name": "back",
  "version": "0.0.1",
  "private": true,
  "license": "UNLICENSED",
  "scripts": {
    "prebuild": "rimraf dist",
    "build": "nest build",
    "start:dev": "DB_ENVFILE=db nest start --watch",
    "start:prod": "DB_ENVFILE=db node dist/main"
  },
  "dependencies": {
    "@nestjs/common": "^9.0.0",
    "@nestjs/core": "^9.0.0",
    "pg": "^8.8.0",
    "typeorm": "^0.3.10"
  },
  "devDependencies": {
    "typescript": "^4.7.4"
  }
}

问题原因 #

1. 卷挂载覆盖问题：docker-compose中- ./back:/app的绑定挂载会将本地back目录完整覆盖容器内的/app目录。容器中通过RUN npm i安装的node_modules位于/app下，被本地目录（本地可能未安装依赖或依赖与容器环境不兼容）覆盖，导致Node.js无法找到模块。
2. 环境变量设置问题：Base阶段设置了NODE_ENV=production，Dev阶段未修改该变量，npm i在生产环境下不会安装devDependencies，虽当前问题主要由挂载导致，但可能引发后续开发依赖缺失的问题。

解决方案 #

方案1：保留容器内的node_modules（推荐） #

修改docker-compose.yml中backend服务的volumes配置，添加匿名卷保留容器内的node_modules：

services:
  backend:
    # ...其他配置不变
    volumes:
      - ./back:/app
      - /app/node_modules  # 匿名卷，避免本地目录覆盖容器内的node_modules

方案2：调整Dev阶段的环境变量 #

在Dockerfile的Dev阶段添加环境变量设置，确保安装所有依赖：

#dev
FROM base AS dev

ENV NODE_ENV=development  # 切换到开发环境
RUN npm i
COPY . .

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

方案3：本地同步依赖（不推荐） #

在本地back目录执行npm i安装依赖，确保本地node_modules与容器内一致，但这种方式可能因本地与容器系统差异（如Windows vs Alpine Linux）导致依赖兼容性问题。

验证步骤 #

1. 停止现有容器：docker-compose down
2. 重新构建镜像：docker-compose build backend
3. 启动服务：docker-compose up backend
4. 检查日志，确认模块解析错误消失，服务正常启动。

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