Node.js(Express)服务运行正常但请求无响应问题排查求助

这种间歇性的请求挂起问题真的很磨人，我之前在Node/Express项目里也碰到过类似的情况，咱们一步步拆解可能的原因，逐个排查：

1. 请求被意外挂起（未正确结束响应） #

这是最常见的原因之一——你的路由或中间件里可能忘记调用响应结束方法，比如res.send()、res.json()或者next()，导致请求一直处于等待状态，时间久了连接池被占满，后续请求全部卡住。

比如这种典型的错误：

app.get('/api/data', (req, res) => {
  // 发起数据库查询，但没处理Promise的回调
  db.query('SELECT * FROM user')
  // 漏掉了 .then(result => res.json(result)) 或者 .catch(err => res.status(500).send(err))
})

排查技巧：

• 在所有路由的最后添加一个监控中间件，检查请求是否未被响应：

app.use((req, res, next) => {
  if (!res.headersSent) {
    console.warn(`请求 ${req.method} ${req.path} 未被响应！`);
    res.status(500).send('请求处理超时');
  }
})

• 检查所有异步操作（Promise、回调）是否都有完整的处理分支，包括错误情况。

2. 事件循环被阻塞 #

Node.js是单线程事件循环模型，如果存在CPU密集型操作（比如超大循环、复杂加密计算）或者同步阻塞方法（比如fs.readFileSync、mysql.querySync），会直接卡住事件循环，导致后续请求无法被处理。

举个例子：

app.get('/api/heavy-calc', (req, res) => {
  let total = 0;
  for (let i = 0; i < 1e9; i++) { // 这个循环会阻塞事件循环数秒
    total += i;
  }
  res.send({ total });
})

排查技巧：

• 用node --trace-event-loop server.js启动服务，查看事件循环的阻塞日志；
• 用clinic.js工具生成性能分析报告，定位阻塞点；
• 替换所有同步阻塞方法为异步版本，CPU密集型操作可以考虑用子进程（child_process）或者Worker线程处理。

3. 数据库/外部服务连接池耗尽 #

如果你的后端频繁调用数据库或外部API，却没有合理配置连接池，当请求量超过连接池上限时，新的请求会一直等待空闲连接，表现为请求挂起。

比如mysql2连接池配置过小：

const pool = mysql.createPool({
  host: 'localhost',
  user: 'root',
  connectionLimit: 5 // 仅允许5个并发连接，请求量上来就会排队
})

排查技巧：

• 检查数据库连接池的connectionLimit配置，根据实际请求量调整；
• 确认所有数据库查询后都正确释放了连接（比如用pool.release()或者依赖连接池自动管理）；
• 查看数据库的连接数监控，看是否达到上限。

4. 内存泄漏导致服务性能退化 #

长时间运行后，内存泄漏会导致Node.js进程内存占用持续升高，GC（垃圾回收）频繁触发，进而阻塞事件循环，最终导致请求无响应。常见的内存泄漏场景：

• 全局变量意外挂载（比如global.cache = []不断添加数据却从不清理）；
• 未清除的定时器/事件监听器（比如setInterval没调用clearInterval，或者eventEmitter.on后没移除监听器）；
• 闭包引用导致的内存无法释放（比如回调函数长期持有大对象引用）。

排查技巧：

• 用node --inspect server.js启动服务，打开Chrome DevTools的Memory面板，定期抓取堆快照对比，找出内存增长的来源；
• 用process.memoryUsage()在代码中打印内存占用，监控变化趋势。

5. 网络或代理层问题 #

如果前端和后端之间存在代理（比如React的proxy配置、Nginx反向代理），可能是代理的超时设置或连接管理出了问题：

• React的proxy配置可能存在连接复用的问题，尝试重启前端服务或改用手动代理；
• Nginx的proxy_connect_timeout、proxy_read_timeout设置过短，导致连接被提前断开；
• 服务器防火墙、端口占用或网络波动，导致请求无法正常到达后端。

6. 错误处理缺失导致异常被吞掉 #

有些时候，请求挂起是因为异步错误被吞掉，导致代码执行卡在错误点，既不响应也不报错。比如：

app.get('/api/async-data', async (req, res) => {
  // 没有try/catch包裹，异步错误会被静默吞掉
  const data = await db.query('SELECT * FROM invalid_table');
  res.json(data);
})

排查技巧：

• 给所有异步操作添加错误处理（Promise的.catch()、async/await的try/catch）；
• 配置Express全局错误处理中间件，捕获所有未处理的错误：

app.use((err, req, res, next) => {
  console.error('未捕获的错误:', err.stack);
  res.status(500).json({ error: '服务器内部错误' });
})

建议先从“未正确结束响应”和“错误处理缺失”这两点开始排查，这两个是最容易忽略也最常见的问题。

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