Express.js中ERR_HTTP_HEADERS_SENT错误的正确处理方法咨询

首先得明确，你遇到的ERR_HTTP_HEADERS_SENT错误本质上是因为你在已经发送响应体（比如调用res.json）之后，又尝试修改响应头（res.cookie）——这在HTTP协议里是不允许的，因为响应头必须在响应体之前发送。

为什么你的当前处理没生效？ #

你错误处理中间件里的if (res.headersSent) return next(err);逻辑是：如果响应头已经发送，就把错误传给下一个中间件。但Express的默认错误处理中间件遇到这类错误时，还是会输出错误栈甚至导致应用崩溃，因为这属于不可恢复的操作错误——毕竟响应已经发出去了，没法再补救，默认处理只能把错误抛出来。

正确的处理方式分两步： #

1. 从根源避免触发这个错误（最优解）

最根本的解决办法是永远不要在发送响应体之后操作响应头。你可以调整代码顺序，把res.cookie放在res.json之前（因为res.cookie只是设置响应头，不会发送响应）：

// 先设置Cookie（修改响应头）
res.cookie("jwt", newRefreshToken, {
  httpOnly: true,
  secure: true,
  sameSite: "None",
  maxAge: 24 * 60 * 60 * 1000,
});
// 再发送响应体
res.json({
  _id: user._id,
  username: user.username,
  email: user.email,
  token: generateToken(user.id, "ACCESS_TOKEN_SECRET", "20s"),
});

如果因为逻辑原因必须在某个条件下才发送响应，那就在发送响应后用return终止后续代码执行，避免误操作：

res.json({
  _id: user._id,
  username: user.username,
  email: user.email,
  token: generateToken(user.id, "ACCESS_TOKEN_SECRET", "20s"),
});
return; // 终止后续代码，不会执行到res.cookie
res.cookie("jwt", newRefreshToken, {
  httpOnly: true,
  secure: true,
  sameSite: "None",
  maxAge: 24 * 60 * 60 * 1000,
});

2. 修改错误处理中间件，避免应用崩溃

如果不小心触发了这个错误，你需要在自定义错误处理中间件里专门捕获ERR_HTTP_HEADERS_SENT错误，记录日志后直接返回，而不是传给默认处理：

function errorHandler(err, req, res, next) {
  // 专门处理ERR_HTTP_HEADERS_SENT错误
  if (err.message.includes('ERR_HTTP_HEADERS_SENT')) {
    console.warn('警告：尝试在响应发送后修改响应头，已忽略:', err.message);
    return; // 直接返回，不传给默认错误处理
  }

  // 处理其他未发送响应的错误
  if (!res.headersSent) {
    res.status(err.statusCode || 500);
    res.json({
      error: err.message || '服务器内部错误'
    });
  } else {
    console.warn('响应已发送，无法处理错误:', err.message);
  }
}

这样处理后，即使不小心触发了这个错误，应用也不会崩溃，只会在控制台输出警告日志，不会影响其他请求。

补充说明 #

ERR_HTTP_HEADERS_SENT属于操作型错误，不是业务错误，所以最好的实践是从代码逻辑上避免它，而不是依赖错误处理中间件来擦屁股。毕竟响应发送后再修改头是违反HTTP规范的行为，应该从根源杜绝。

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