Docker容器中开发依赖未安装，Express容器启动报nodemon未找到

问题原因分析 #

出现这个错误核心有两个原因：

• 容器内安装的node_modules被本地目录挂载覆盖：你的docker-compose.yml中把本地./backend目录挂载到容器的/app，如果本地未安装nodemon（或本地node_modules中没有该依赖），容器内通过npm install安装的依赖会被本地目录覆盖。
• NODE_ENV环境变量未持久化：Dockerfile里仅在RUN命令临时设置NODE_ENV=development，该环境变量不会传递到后续CMD执行阶段，若后续阶段NODE_ENV默认是production，nodemon作为开发依赖会被忽略。

具体解决方案 #

1. 修改后端Dockerfile，持久化开发环境变量

将临时环境变量改为全局设置，确保构建和运行阶段都处于开发环境：

FROM node:alpine

WORKDIR /app

# 全局设置开发环境变量
ENV NODE_ENV=development

COPY package*.json ./

RUN npm install

COPY . .

EXPOSE 5000

CMD ["npm","run","server"]

2. 修改docker-compose.yml，保护容器内的node_modules

添加匿名卷挂载/app/node_modules，避免本地目录覆盖容器内安装的依赖：

version: '3'
services:
  client:
    build: 
      context: './frontend'
      dockerfile: Dockerfile
    ports:
    - 3000:3000
    container_name: react_cont
    environment:
      - WATCHPACK_POLLING=true
    networks:
    - mern
    volumes:
    - ./frontend:/app
    # 给前端也添加node_modules保护卷，避免同类问题
    - /app/node_modules
    depends_on:
    - server
  server:
    build:
      context: './backend'
      dockerfile: Dockerfile
    ports:
    - 5000:5000
    container_name: express_cont
    networks:
    - mern
    volumes:
    - ./backend:/app
    # 添加该行，防止本地目录覆盖容器内的node_modules
    - /app/node_modules
networks:
  mern:

3. 确认后端package.json配置

确保启动脚本和依赖配置正确：

{
  "scripts": {
    "server": "nodemon server.js" // 替换为你的实际入口文件名
  },
  "devDependencies": {
    "nodemon": "^x.x.x" // 确保nodemon已添加到开发依赖
  }
}

4. 重新构建启动容器

执行以下命令清理旧容器并重新构建：

docker-compose down
docker-compose build --no-cache
docker-compose up

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