API Error [ERR_HTTP_HEADERS_SENT]求助：注册/登录偶发报错

这个ERR_HTTP_HEADERS_SENT错误的核心原因是：服务器已经向客户端发送了一次响应（比如用res.send/res.json返回结果），但后续代码又尝试再次发送响应或修改响应头——HTTP协议要求一个请求只能对应一个响应，所以触发了这个报错。

结合注册/登录接口的场景，常见触发情况和解决方法：

• 未及时终止代码执行：比如在if分支里发送响应后，没加return终止函数，导致后续代码继续执行并再次发送响应。
  错误示例：

  if (userExists) {
    res.json({ code: 1, msg: '用户已存在' });
  }
  // 无return，后续代码继续执行
  res.json({ code: 0, msg: '注册成功' });
  

  解决：发送响应后立即用return终止逻辑：

  if (userExists) {
    return res.json({ code: 1, msg: '用户已存在' });
  }
  res.json({ code: 0, msg: '注册成功' });
  

• 异步逻辑处理不当：比如数据库查询这类异步回调里发送了响应，但外层代码也提前发送了响应，导致两次响应。
  错误示例：

  db.query('SELECT * FROM users WHERE email = ?', [email], (err, result) => {
    if (result.length > 0) {
      res.json({ code: 1, msg: '用户已存在' });
    }
  });
  res.json({ code: 0, msg: '注册成功' });
  

  解决：确保异步逻辑内的响应是唯一的，外层不要提前发送响应：

  db.query('SELECT * FROM users WHERE email = ?', [email], (err, result) => {
    if (err) throw err;
    if (result.length > 0) {
      return res.json({ code: 1, msg: '用户已存在' });
    }
    // 执行注册逻辑后再发送响应
    res.json({ code: 0, msg: '注册成功' });
  });
  

• 路由/中间件重复配置：如果注册/登录接口被重复挂载，或者中间件逻辑重复发送响应，也会触发该错误。
  解决：检查路由配置，确保每个请求只被一个路由处理，中间件不要重复执行响应操作。

总结：排查代码中所有发送响应的位置，保证每个请求只会触发一次res.send/res.json/res.end这类响应方法，且发送响应后立即终止后续代码执行。

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