Docker配置卷后nodemon无法热重载的问题求助

核心问题分析 #

你的配置存在两个关键问题导致nodemon无法触发热重载：

1. Alpine镜像缺失文件监听依赖：nodemon依赖inotify-tools捕获文件系统变化，但Alpine Linux作为轻量镜像默认未预装该工具。
2. 卷挂载覆盖容器内依赖：直接将本地目录挂载到容器/app会覆盖容器中通过RUN npm install安装的依赖目录，同时容器内的文件系统事件传递可能存在异常。

具体修复步骤 #

1. 为Alpine镜像安装inotify-tools #

修改Dockerfile，在安装全局nodemon的步骤后添加inotify-tools的安装命令：

FROM node:18-alpine

# 安装文件监听依赖与全局nodemon
RUN apk add --no-cache inotify-tools && npm install -g nodemon

WORKDIR /app

COPY package*.json .

RUN npm install

COPY . .

EXPOSE 8080

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

2. 保留容器内的node_modules目录 #

在docker-compose.yml中添加匿名卷挂载，避免本地目录覆盖容器内已安装的依赖：

services:
  api:
    build: .
    container_name: random-api
    volumes:
      - ./:/app
      - /app/node_modules  # 保留容器内的依赖目录
    environment:
      - PORT=8080
    ports:
      - "4000:8080"

3. 强制nodemon使用轮询模式（备选方案） #

如果安装inotify-tools后仍存在问题，可修改package.json的dev命令，添加--legacy-watch参数让nodemon用轮询模式监听文件变化：

"scripts": {
    "dev": "nodemon --legacy-watch server.js"
  },

也可以在项目根目录创建nodemon.json配置文件统一设置：

{
  "watch": ["server.js"],
  "legacyWatch": true
}

验证修复 #

1. 重新构建镜像：docker-compose build
2. 启动容器：docker-compose up
3. 修改server.js代码后，查看容器日志会看到nodemon重启的记录，访问http://localhost:4000即可看到更新后的内容。

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