Node.js操作MongoDB出现ERR_HTTP_HEADERS_SENT错误如何解决？

核心报错本质 #

Error [ERR_HTTP_HEADERS_SENT] 是Node.js HTTP服务的常见错误，触发原因是单次HTTP请求流程中，代码先后两次向客户端发送了响应内容，第二次尝试修改响应头/返回数据时就会抛出该错误。

代码存在的具体问题 #

• 最直接的报错触发原因：参数校验通过后调用了next()，将请求转发给了后续中间件/路由处理函数，后续逻辑会给客户端返回一次响应；但你调用next()后没有终止当前函数执行，当前函数后续的数据库操作执行完又调用res.redirect("/")返回第二次响应，直接触发报错。
• 参数校验逻辑错误：使用||（或）判断，只要三个参数有一个不为undefined就放行，不符合必填校验逻辑，应该改为&&（与）确保三个参数都存在才继续执行。
• 重复建立MongoDB连接：外层已经调用client.connect()建立了连接，内层不需要再次调用MongoClient.connect()，多余的连接操作会导致资源泄露、逻辑异常。
• 异步操作未等待：insertOne是异步方法，没有等待它执行完成就调用res.redirect和关闭连接，可能出现数据写入失败、连接提前关闭的问题。
• 参数校验失败分支直接return err，没有给客户端返回响应，会导致请求无限挂起。

修正后代码示例 #

const postTitle = req.body.postTitle;
const postDescription = req.body.postDescription;
const socialLink = req.body.socialLink;

// 参数校验：三个参数都存在才继续
if (!postTitle || !postDescription || !socialLink) {
  // 校验失败直接返回错误响应，终止后续逻辑
  return res.status(400).send('缺少必填参数');
}

try {
  // 直接使用已经建立的client连接，不需要重复connect
  const database = client.db("myFirstDatabase");
  const socialPosts = database.collection("socialPosts");
  // 等待异步插入操作完成
  await socialPosts.insertOne({ 
    title: postTitle, 
    description: postDescription, 
    socialLink: socialLink 
  });
  // 插入成功后跳转
  res.redirect("/");
} catch (err) {
  // 异常处理，返回错误响应
  console.error('数据插入失败：', err);
  res.status(500).send('服务器内部错误');
}

注意：如果你要使用await语法，需要将当前函数改为async函数。如果你习惯用Promise链式调用，也可以保留.then()的写法，只要保证异步操作完成后再调用res.redirect即可。

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