Node.js REST API登录时出现ERR_HTTP_HEADERS_SENT错误求助

嘿，我来帮你搞定这个头疼的错误！这个Error [ERR_HTTP_HEADERS_SENT]本质是重复发送响应导致的——你已经给客户端返回了JSON响应，之后又让Express继续执行后续的中间件/路由逻辑，而这些逻辑大概率会再次尝试修改响应头或者发送响应，直接触发了冲突。

问题出在哪？ #

看你的登录控制器代码：

export async function login(req, res, next) {
  res.status(HTTPStatus.OK).json(req.user.toAuthJSON());
  return next();
}

这里的res.status(...).json(...)已经把完整的响应发送给客户端了，但紧接着调用的next()会让Express把请求传递给后续的中间件/处理函数。这些后续的代码如果再调用res.send()、res.json()或者修改响应头，就会触发这个错误。

怎么修复？ #

非常简单——发送完响应后就不要再调用next()了，因为请求已经处理完成，不需要再走后续的处理流程。修改后的代码如下：

export async function login(req, res, next) {
  // 直接返回响应，结束请求流程
  return res.status(HTTPStatus.OK).json(req.user.toAuthJSON());
}

额外提醒 #

如果后续有错误处理中间件（比如捕获异常的(err, req, res, next)格式中间件），只有在发生异常的时候才需要调用next(err)来传递错误。正常处理完请求返回响应后，直接结束即可，不需要调用任何next()。

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