M1 MacBook Docker容器中Node应用启动失败求助

• 强制开启nodemon调试日志
  把启动命令里的nodemon替换成nodemon -L --verbose：-L强制用轮询方式监听文件变化（Docker卷挂载时，M1的文件系统事件可能无法正常传递给容器内的nodemon），--verbose会输出nodemon的全流程日志，包括是否定位到入口文件、是否尝试启动Node进程、有没有加载异常等细节，帮你定位卡壳环节。

• 跳过nodemon直接启动服务
  临时修改Docker启动命令，比如把nodemon src/index.js换成node src/index.js，测试服务本身能不能正常启动。如果能启动，说明问题集中在nodemon与M1架构/容器文件系统的兼容上；如果还是无响应，那问题出在Node服务本身，比如依赖包的arm64兼容问题。

• 确认Docker镜像架构适配细节
  虽然你已经指定了架构，但再做两个检查：

  • Dockerfile里的基础镜像要选支持arm64的版本，比如FROM node:20-bookworm，避免用仅支持amd64的旧镜像；
  • 如果本地挂载了node_modules卷，M1的arm64依赖和amd64依赖不兼容，直接删掉本地的node_modules目录，让容器内部重新执行npm install安装适配arm64的依赖。

• 查看容器实时日志和进程状态

  • 用docker logs -f <你的服务容器名>实时跟踪容器日志，即使nodemon没输出，Node进程可能有错误日志被吞了；
  • 用docker exec -it <你的服务容器名> ps aux查看容器内的进程列表，确认nodemon和Node进程是否存在，有没有僵死的进程。

• 检查文件权限和挂载问题
  M1的Docker卷挂载可能存在权限问题，导致nodemon无法监听文件或者服务无法读取配置：

  • 在Dockerfile里添加RUN chown -R node:node /app（假设你的工作目录是/app），用非root用户运行服务；
  • 确认本地挂载的目录没有特殊字符，且文件系统是APFS（M1默认），部分旧版nodemon对APFS的文件事件支持不佳，用-L参数可以规避这个问题。

• 更新nodemon和Node版本
  旧版nodemon在arm64架构下存在已知的兼容性bug，把package.json里的nodemon升级到最新稳定版（执行npm install nodemon@latest --save-dev），同时Node版本尽量选用LTS版本，减少架构适配问题。

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