Node.js v21.6.2下nodemon启动应用崩溃求助

核心排查与修复步骤 #

• 先定位应用本身的错误
  nodemon只是进程重启工具，崩溃根源在你的业务代码里。直接执行 node app.js（替换成你的入口文件名）启动应用，此时控制台会输出完整的错误栈信息（比如未捕获异常、模块缺失、端口占用等），这是最关键的排查依据。
• 校验nodemon启动配置
  检查项目根目录的 nodemon.json 或 package.json 中的脚本配置，确保启动命令指向正确的入口文件，无拼写错误。示例：

  // package.json 正确配置示例
  {
    "scripts": {
      "dev": "nodemon ./src/index.js"
    }
  }
  

• 清理并重建依赖
  部分依赖可能与Node.js v21存在兼容性问题，执行以下命令重置依赖：

  npm cache clean --force
  rm -rf node_modules package-lock.json
  npm install
  

• 检查端口占用情况
  如果应用监听了固定端口，确认端口未被其他进程占用：

  # Linux/macOS
  lsof -i :3000
  # Windows
  netstat -ano | findstr :3000
  

  若端口被占用，杀掉对应进程或修改应用监听的端口号。
• 切换至Node.js稳定版
  Node.js v21为开发版，存在未知兼容性风险，可通过nvm切换至LTS稳定版（如v20.x）：

  nvm install 20
  nvm use 20
  

常见代码层面修复 #

• 给所有异步操作（数据库查询、API请求等）添加 try/catch 或 .catch() 捕获异常，避免未处理的Promise拒绝导致进程崩溃。
• 检查所有 require/import 语句，确保文件路径、模块名称拼写正确，依赖已正常安装。
• 确认 .env 环境变量文件配置完整，且通过 dotenv 正确加载，避免因缺失配置导致的初始化错误。

内容的提问来源于stack exchange，提问作者Mohammed Nur Nabi