Mac M1环境Docker容器内启动nodemon报Device timeout错误

API 探路者

2026-9-3

问题根因

这个报错和你调整的nodemon监听延迟、忽略规则没有关系，是Docker挂载配置错误叠加M1芯片Mac的文件系统兼容问题导致的：

全量目录挂载覆盖了容器内的依赖：你在Dockerfile构建阶段已经在容器内/usr/src/app路径下执行yarn install安装了适配Alpine Linux环境的依赖（包括nodemon），但启动容器时直接把本地整个项目目录挂载到容器同路径，容器内原本装好的node_modules会被你本地Mac环境下的node_modules完全覆盖。本地依赖是针对darwin arm64架构编译的，和容器内的musl libc运行环境不兼容，系统无法执行nodemon二进制文件就会抛出错误。
M1芯片Mac默认的Docker挂载方案对inotify类工具兼容性差：默认的gRPC-FUSE挂载模式IO延迟高，nodemon这类依赖文件系统事件监听的工具很容易触发设备超时错误。

修复步骤

调整挂载规则，保护容器内的node_modules目录不被覆盖
启动容器时新增一个匿名卷，单独挂载容器内的node_modules路径，避免被本地目录替换：
```
docker run -p 3000:8080 --name my-container -v ${PWD}:/usr/src/app -v /usr/src/app/node_modules my-app
```
调整后你本地的代码修改可以正常同步到容器，容器内的Linux版依赖会被保留，不会出现二进制不兼容的问题。
（若第一步操作后仍有超时）优化Docker挂载性能
打开Docker Desktop设置，在开发特性配置页开启VirtioFS加速目录共享，同时勾选使用新的虚拟化框架，重启Docker后再启动容器。VirtioFS是目前M1 Mac上Docker目录挂载兼容性、性能最好的方案，可以解决绝大多数文件监听超时、IO卡顿问题。
（可选生产环境优化）去掉nodemon依赖
如果是部署正式环境，不需要热重载能力，可以直接把Dockerfile的启动命令改成用node直接运行，完全绕开文件监听的兼容问题：
```
CMD ["node", "server.js"]
```

验证流程

执行以下命令重新部署即可：

# 删除旧的异常容器
docker rm -f my-container
# 重新构建镜像
docker build -t my-app .
# 用调整后的挂载参数启动容器
docker run -p 3000:8080 --name my-container -v ${PWD}:/usr/src/app -v /usr/src/app/node_modules my-app

启动成功后可以看到nodemon的正常运行日志，访问http://localhost:3000即可正常访问服务，修改本地代码后nodemon也会自动重启服务进程。

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