Express未捕获异常时req.params变为undefined的原因排查

当Express路由处理函数中抛出未捕获异常时，req对象的属性被清理是Express内部错误处理机制的设计结果，具体原因如下：

1. 异常触发内置错误处理流程
   一旦路由处理函数抛出未捕获异常，Express会自动将异常传递给内置的错误处理中间件。在这个流程中，Express会启动请求响应周期的收尾工作，其中就包括对req和res对象的清理。

2. 请求对象的清理逻辑
   为了避免内存泄漏，Express在异常处理的收尾阶段会主动清理req对象上的附加属性——包括由路由解析生成的params、查询参数query、请求体body等，同时解除请求对象上绑定的事件监听器、断开与底层socket的关联，确保这些对象能被垃圾回收机制正确处理。

3. finish事件的触发时机
   res.finish事件在响应完全发送到客户端后触发，此时异常引发的清理流程已经执行完毕，req对象的大部分附加属性已经被移除，所以你会看到req.params变为undefined，其他属性也被清理。

而在正常无异常的流程中，Express不会立即执行这种激进的清理操作，响应完成后req对象的属性会保留一段时间，直到垃圾回收机制自动处理，因此finish回调中还能正常访问req.params。

如果需要在finish回调中获取请求参数，可以提前保存参数的副本：

const express = require('express')
const app = express()
const port = 3000

app.get('/foo/:id', (req, res) => {
  // 提前复制参数，避免后续被清理
  const savedParams = {...req.params};
  res.on('finish', () => console.log("params are:", savedParams))
  throw 'big error';
})

app.listen(port, () => {
  console.log(`Example app listening on port ${port}`)
})

或者在错误处理中间件中直接处理参数（此时req属性尚未被完全清理）：

const express = require('express')
const app = express()
const port = 3000

app.get('/foo/:id', (req, res, next) => {
  throw 'big error';
})

// 自定义错误处理中间件
app.use((err, req, res, next) => {
  console.log("params in error handler:", req.params);
  res.status(500).send('Server Error');
})

app.listen(port, () => {
  console.log(`Example app listening on port ${port}`)
})

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