使用Docker Compose部署Node.js Express应用遇Nodemon启动失败求助

核心问题分析 #

你遇到的Nodemon failed to start process because node exec was not found错误，本质是nodemon在容器环境里找不到系统级的Node可执行文件，你之前安装的node npm包没用——npm装的是Node的源码包，不是系统可执行程序，官方Node镜像自带的才是正确的可执行文件。

针对性排查步骤 #

1. 检查Dockerfile基础镜像

确保使用官方Node镜像，不要用无预装Node的基础镜像（比如alpine裸镜像）。正确的Dockerfile开头示例：

FROM node:18-alpine  # 或node:20、node:16，根据你的项目版本选择
WORKDIR /app
COPY package*.json ./
RUN npm install  # 这里不要加npm install node --save-dev
COPY . .
CMD ["npm", "run", "dev"]

2. 修正package.json的启动脚本

显式指定nodemon用系统级node执行，避免路径识别问题：

{
  "scripts": {
    "dev": "nodemon --exec node app.js"  // 替换成你的入口文件
  },
  "devDependencies": {
    "nodemon": "^3.0.0"  // 确保nodemon已在dev依赖中
  }
}

3. 调整Docker Compose的挂载配置

如果你的compose里挂载了本地目录到容器，会覆盖容器内的node_modules，导致nodemon依赖丢失。添加/app/node_modules挂载保留容器内的依赖：

services:
  app:
    build: .
    volumes:
      - .:/app  # 挂载本地代码到容器
      - /app/node_modules  # 保留容器内的node_modules，不被本地覆盖
    ports:
      - "3000:3000"

4. 强制重新构建镜像

之前的缓存可能残留错误配置，执行强制构建：

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

5. 验证容器内Node是否存在

如果以上步骤无效，进入容器直接检查：

docker-compose exec app which node

如果返回/usr/local/bin/node，说明Node存在，问题出在nodemon配置；如果无返回，说明基础镜像未预装Node，立刻更换官方Node镜像。

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