Express中POST请求出现ERR_HTTP_HEADERS_SENT错误求解决

问题描述 #

在Express框架中向 /api/auth/login 发送POST请求时，触发以下错误，接口返回500状态码（预期返回200）：

POST /api/auth/login 500 118.471 ms - 421
Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client
    at new NodeError (node:internal/errors:399:5)
    at ServerResponse.setHeader (node:_http_outgoing:663:11)        
    at ServerResponse.header (C:\Users\Михаил\Desktop\code\workout-app\wa-server\node_modules\express\lib\response.js:794:10)
    at ServerResponse.send (C:\Users\Михаил\Desktop\code\workout-app\wa-server\node_modules\express\lib\response.js:174:12)
    at ServerResponse.json (C:\Users\Михаил\Desktop\code\workout-app\wa-server\node_modules\express\lib\response.js:278:15)
    at errorHandler (file:///C:/Users/%D0%9C%D0%B8%D1%85%D0%B0%D0%B8%D0%BB/Desktop/code/workout-app/wa-server/app/middleware/error.middleware.js:10:7)
    at Layer.handle_error (C:\Users\Михаил\Desktop\code\workout-app\wa-server\node_modules\express\lib\router\layer.js:71:5)
    at trim_prefix (C:\Users\Михаил\Desktop\code\workout-app\wa-server\node_modules\express\lib\router\index.js:326:13)
    at C:\Users\Михаил\Desktop\code\workout-app\wa-server\node_modules\express\lib\router\index.js:286:9
    at Function.process_params (C:\Users\Михаил\Desktop\code\workout-app\wa-server\node_modules\express\lib\router\index.js:346:12)

涉及代码模块：

• 错误处理中间件
• 认证控制器（3段核心逻辑）
• 认证路由配置

错误核心原因 #

这个错误本质是已经给客户端发过响应了，后续代码又试图修改响应头或再次发送响应。结合错误栈看，是errorHandler中间件调用res.json()时，之前的请求处理已经发送过响应，导致冲突。

修复步骤 #

1. 检查登录控制器逻辑 #

• 确认login函数中，发送成功响应（比如res.status(200).json(...)）后，是否用return终止了后续代码执行。如果没加return，后续代码可能继续触发错误处理流程，导致二次响应。
• 示例修正：

  const login = async (req, res, next) => {
    try {
      // 用户名密码验证逻辑...
      if (验证通过) {
        // 发送成功响应后立即终止函数
        return res.status(200).json({ token, userInfo });
      }
      // 其他分支逻辑...
    } catch (err) {
      next(err); // 仅在未发送响应时，交给错误中间件处理
    }
  };
  

2. 修复错误处理中间件 #

在error.middleware.js中添加判断，确保只在未发送响应时才执行响应操作：

const errorHandler = (err, req, res, next) => {
  const statusCode = err.status || 500;
  const message = err.message || '服务器内部错误';
  
  // 避免重复发送响应
  if (!res.headersSent) {
    res.status(statusCode).json({ message });
  }
};

3. 排查路由配置 #

确认/api/auth/login路由没有被重复注册，也没有多个中间件在处理该请求时都发送了响应。

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