Express服务启动后无异常信息直接崩溃问题排查（Node.js）

使用Express 4.18.2版本，执行node ./src/index.js启动服务器时，服务器仅启动瞬间就崩溃，未抛出任何异常或错误信息。尝试在index.js中添加断点调试，但系统似乎无法识别该文件，怀疑是否是index.js未在node modules中注册？执行npm start也出现相同问题。

我的index.js代码： #

import express from "express";
import dotenv from 'dotenv';
dotenv.config();

const server = express();
server.use(express.json());
server.use(morgan('dev'));

let port = 3000;
server.listen(port, err =>{
    if(err){
        return console.error(err);
    }else{
        return console.log(`🚀 listening on port: ${port}`)
    }
});

package.json配置： #

{
 "name": "innahealth",
 "version": "1.0.0",
 "description": "",
 "type": "module",
 "main": "./src/index.js",
 "scripts": {
   "start": "node ./src/index.js",
   "dev": "nodemon src --exec babel-node",
   "build": "babel src -d dist"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
    "bcryptjs": "^2.4.3",
    "cors": "^2.8.5",
    "dotenv": "^16.0.3",
    "express": "^4.18.2",
    "express-handlebars": "^3.1.0",
    "mongoose": "^6.7.2",
    "morgan": "^1.10.0"
  },
  "devDependencies": {
   "@babel/cli": "^7.19.3",
   "@babel/core": "^7.20.2",
   "@babel/node": "^7.20.2",
   "@babel/preset-env": "^7.20.2",
   "handlebars": "^4.5.0",
   "nodemon": "^2.0.20"
  }
}

问题根源与解决方案 #

1. 缺失Morgan模块的导入语句 #

你的index.js中使用了morgan('dev')中间件，但没有导入morgan模块。由于项目启用了ES模块（type: module），未声明的变量会触发错误，而node在未捕获顶层错误时可能直接静默退出，导致看不到报错信息。

修复方法：在index.js顶部添加morgan的导入：

import express from "express";
import dotenv from 'dotenv';
import morgan from 'morgan'; // 新增该行
dotenv.config();

2. 澄清模块加载误解 #

你的项目代码不需要在node_modules中注册，node_modules仅用于存放第三方依赖包。只要src/index.js路径正确、文件存在，node就能正常加载它。可以先执行ls src（Linux/macOS）或dir src（Windows）确认文件是否存在。

3. 添加顶层错误捕获排查问题 #

为了避免进程静默退出，建议在代码外层包裹错误捕获逻辑，强制输出所有启动阶段的错误：

import express from "express";
import dotenv from 'dotenv';
import morgan from 'morgan';
dotenv.config();

try {
  const server = express();
  server.use(express.json());
  server.use(morgan('dev'));

  let port = 3000;
  server.listen(port, err =>{
      if(err){
          return console.error(err);
      }else{
          return console.log(`🚀 listening on port: ${port}`)
      }
  });
} catch (err) {
  console.error('启动失败:', err);
}

4. 调试工具配置（可选） #

如果用VS Code调试ES模块项目，需在.vscode/launch.json中配置模块类型，确保调试器正确识别：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Server",
      "program": "${workspaceFolder}/src/index.js",
      "env": {"NODE_ENV": "development"},
      "skipFiles": ["<node_internals>/**"]
    }
  ]
}

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