Express JS中间件配置报错：ERR_HTTP_HEADERS_SENT问题求助

这个错误的核心是同一个请求周期内，你已经向客户端发送过一次响应，错误中间件又尝试发送第二次响应，导致HTTP头冲突。

排查方向： #

• 检查路由/业务逻辑代码，确认在调用next(err)之前是否已经发送了响应（比如调用了res.send()、res.json()、res.end()等方法）。错误示例：

  app.get('/api/data', (req, res, next) => {
    res.json({ data: [] }); // 这里已经发送了响应
    next(new Error('数据查询失败')); // 调用next(err)触发错误中间件，重复发送响应
  });
  

• 确认错误中间件的挂载顺序：Express要求错误中间件必须放在所有路由和普通中间件之后，否则可能出现重复触发或提前执行的问题。正确顺序示例：

  // 先挂载所有路由
  app.use('/api', require('./routes'));
  // 最后挂载错误中间件
  app.use(require('./middlewares/error-middleware'));
  

• 检查是否存在重复的错误处理逻辑：比如在路由内部已经捕获错误并发送了响应，又将错误传递给next(err)，导致错误中间件再次处理并发送响应。

修正建议： #

确保在调用next(err)之前，绝不发送任何响应；同时严格遵守Express中间件的挂载顺序，错误中间件必须放在最后。

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