Docker环境下Vite导致Nodemon无法监听重启问题排查

核心原因：Docker挂载卷的文件系统事件传递限制 #

在Windows/macOS环境下，Docker通过虚拟化层挂载本地目录时，容器内的nodemon无法接收本地文件修改的inotify事件，导致无法触发重启。而Vite HMR正常是因为Vite本身适配了Docker环境的文件监听逻辑。

具体解决办法 #

1. 修改nodemon配置，启用轮询模式 #

在nodemon.json中添加poll选项，强制nodemon通过定期轮询检测文件变化：

{
  "watch": ["src", "server.ts"],
  "ext": "ts,tsx",
  "exec": "tsx server.ts",
  "poll": 1000 // 每1000毫秒轮询一次，可根据需求调整间隔
}

也可以直接在启动命令中添加参数：

"dev:server": "npx nodemon --poll 1000",

2. 确认Docker挂载配置正确性 #

检查docker-compose.yml中的卷挂载规则，确保本地项目根目录正确挂载到容器内的工作目录：

services:
  app:
    build: .
    volumes:
      - ./:/app # 本地根目录挂载到容器内的/app路径
    working_dir: /app # 确保容器内工作目录与挂载路径一致

同时避免权限问题导致nodemon无法读取文件变化，可在Dockerfile中设置权限：

RUN chown -R node:node /app # 假设容器使用node用户，根据实际情况调整
USER node

3. 验证nodemon监听路径准确性 #

确认nodemon.json中watch的路径在容器内可正常访问。可以进入容器执行ls -l src server.ts，检查文件是否存在且路径正确。

4. 禁用nodemon缓存（可选） #

若以上方法无效，尝试关闭nodemon缓存避免干扰检测：

{
  "watch": ["src", "server.ts"],
  "ext": "ts,tsx",
  "exec": "tsx server.ts",
  "poll": 1000,
  "noCache": true,
  "ignoreRoot": [".git", "node_modules"]
}

验证方式 #

修改src/server下任意文件并保存，观察容器控制台是否出现[nodemon] restarting due to changes...日志，出现则说明配置生效。

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