使用--exec选项时Nodemon应用崩溃问题排查求助

问题概述 #

• Docker环境运行Node.js应用，依赖MongoDB 4.2
• package.json的dev脚本配置为"nodemon index.js --exec 'npm run lint && node'"时，nodemon返回错误：[nodemon] app crashed - waiting for file changes before starting...
• 脚本改为"nodemon index.js"可正常启动应用
• 升级MongoDB至4.2前无此问题，已尝试更新依赖、终止进程、nodemon.json事件配置等方案无效

崩溃原因排查方向 #

1. Docker容器的Shell语法兼容问题 #

Docker容器默认用sh而非bash，单引号在sh里的解析逻辑和bash不同，导致--exec后的命令无法正确执行。

• 排查操作：
  • 修改dev脚本，用双引号适配sh语法：

    "dev": "nodemon index.js --exec \"npm run lint && node\""
    

  • 或者显式指定bash执行命令：

    "dev": "nodemon index.js --exec 'bash -c \"npm run lint && node\"'"
    

2. Lint命令抛出非零退出码 #

如果lint检查发现代码问题，会返回非零退出码，导致&&后的node命令无法执行，nodemon判定应用启动失败。

• 排查操作：
  • 直接在Docker容器内单独执行lint命令，查看是否存在代码问题：

    docker exec <你的容器ID> npm run lint
    

  • 若lint有错误，先修复代码；如果需要忽略lint警告继续启动（不推荐），可修改命令为npm run lint || true && node

3. Lint阶段触发了MongoDB连接适配问题 #

部分lint工具（比如ESLint的某些插件）在检查代码时会解析执行代码片段，如果这部分代码涉及MongoDB连接，而MongoDB4.2的连接规则（比如认证机制、副本集配置）和旧版本不兼容，会导致lint阶段连接失败抛出错误。

• 排查操作：
  • 检查ESLint配置，确认是否有会执行代码的插件或规则
  • 执行lint时开启调试日志，查看是否有MongoDB连接相关报错：

    docker exec <你的容器ID> npm run lint -- --debug
    

  • 对比MongoDB4.2与旧版本的连接差异，比如4.2默认用SCRAM-SHA-256认证，旧版本可能是SCRAM-SHA-1，确保应用连接配置适配新版本

4. nodemon与依赖版本冲突 #

升级MongoDB后，可能连带更新了Node.js或mongoose等依赖，nodemon版本与新依赖存在兼容性问题，导致执行--exec命令时崩溃。

• 排查操作：
  • 升级nodemon到最新稳定版：

    npm install nodemon@latest --save-dev
    

  • 检查package-lock.json或yarn.lock，排查是否有child_process相关依赖的版本冲突（nodemon依赖该模块执行外部命令）

5. Docker资源或权限限制 #

MongoDB4.2对资源需求更高，执行lint+node启动时，容器可能因CPU/内存不足、权限不够导致启动失败。

• 排查操作：
  • 查看容器日志，确认是否有资源不足的报错：

    docker logs <你的容器ID>
    

  • 调整容器资源限制，比如启动时添加--cpus=2 --memory=2g参数
  • 检查容器内用户权限，确保node进程能读写代码目录、正常连接MongoDB

参考配置示例 #

package.json脚本 #

{
  "scripts": {
    "dev": "nodemon index.js --exec 'npm run lint && node'",
    "lint": "eslint ."
  }
}

Dockerfile #

FROM node:16-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
CMD ["npm", "run", "dev"]

MongoDB副本集配置 #

storage:
  dbPath: /data/db
net:
  port: 27017
replication:
  replSetName: rs0

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