如何调试挂起的Express服务器？中间件误用场景排查

这个问题是Express开发里很典型的「中间件调用方式错误」陷阱——你把中间件工厂函数本身传给了app.use()，而不是调用工厂函数后返回的实际处理请求的中间件函数，导致Express一直在等待一个能处理请求的函数，最终服务器挂起。下面分享几个实用的调试方法：

1. 先检查中间件的类型与调用状态 #

首先得明确：Express要求中间件必须是(req, res, next)格式的函数。如果你的中间件是工厂模式（比如例子里的m，它是一个返回中间件的函数），必须调用它（加()）才能拿到真正可用的中间件。

你可以在app.use前后加日志，直观查看传入的内容：

console.log('传入app.use的内容:', m);
console.log('传入内容的类型:', typeof m);

// 对比调用后的情况
console.log('调用m()后得到的内容:', m());
console.log('调用后内容的类型:', typeof m());

如果输出显示传入的是一个function，但调用后返回的还是一个function，那问题就明确了——你忘了调用工厂函数，直接把它传给了Express。

2. 给中间件加日志，追踪执行流程 #

给你的中间件工厂和实际中间件都加上日志，就能清楚看到代码有没有走到正确的步骤：

const m = () => {
  console.log('✅ 中间件工厂函数m被调用了');
  return (req, res, next) => {
    console.log('✅ 实际中间件开始处理请求');
    next();
  };
};

启动服务器后发一个请求，如果看不到✅ 中间件工厂函数m被调用了这条日志，说明你根本没触发工厂函数的执行，Express一直在等它返回能处理请求的函数，自然就挂起了。

同时，给Express加一个全局错误处理中间件，能帮你排查是否有隐藏的错误：

app.use((err, req, res, next) => {
  console.error('❌ 服务器发生错误:', err);
  res.status(500).send('服务器内部错误');
});

3. 用Node.js调试器单步跟踪 #

用Node.js内置的调试工具或者VS Code的调试功能，单步执行代码：

• 启动调试：node inspect your-server-file.js
• 在app.use(m)这一行加断点，查看传入的m是什么；再跟踪Express处理这个中间件的流程，你会发现Express尝试执行m，但m执行后返回的是另一个函数，并没有调用next()，导致请求一直卡在处理队列里。

4. 单独验证中间件的正确性 #

可以脱离Express环境，单独测试你的中间件是否正常工作：

const testMiddleware = m();
// 模拟请求对象、响应对象和next函数
testMiddleware({}, {}, () => console.log('✅ next被正常调用'));

如果这个测试能正常打印✅ next被正常调用，说明中间件本身是没问题的，问题完全出在你没有在app.use里调用工厂函数。

内容的提问来源于stack exchange，提问作者Salah Eddine Taouririt