Node.js MongoDB中.then触发ERR_HTTP_HEADERS_SENT错误求助

错误本质说明 #

这个错误和Node版本关系不大，核心问题是你在同一个请求中多次调用了响应方法（比如res.json、res.send）。比如你的app.get路由里，可能在.then代码块之前已经发送过一次响应，或者路由存在其他分支也执行了响应逻辑，导致后续的res.status(200).json(books)再次发送响应时，客户端已经收到结果，从而触发报错。

替代.then的主流写法：async/await #

这是当前Node.js处理异步操作的标准方式，相比.then的链式写法更直观，也更容易避免重复发送响应的问题。以下是对应代码示例：

第一步：改写db.js的数据库方法（用async/await封装） #

// db.js
const { MongoClient } = require('mongodb');
const url = 'mongodb://localhost:27017';
const dbName = '你的数据库名称';

// 用async标记异步函数
async function getBooks() {
  const client = await MongoClient.connect(url);
  const db = client.db(dbName);
  // await直接获取查询结果
  const books = await db.collection('books').find().toArray();
  client.close();
  return books;
}

module.exports = { getBooks };

第二步：在app.js中用async/await处理路由 #

// app.js
const express = require('express');
const app = express();
const { getBooks } = require('./db.js');

// 给路由处理函数加上async标记
app.get('/books', async (req, res) => {
  try {
    // await等待数据库查询完成，直接拿到结果
    const books = await getBooks();
    // 只发送一次响应
    res.status(200).json(books);
  } catch (err) {
    // 统一捕获异步操作的错误，返回错误响应
    res.status(500).json({ error: err.message });
  }
});

app.listen(3000, () => console.log('服务器运行在3000端口'));

为什么这种写法能避免错误？ #

async/await是线性写法，你能清晰看到响应只在获取到书籍数据后发送一次，不会像.then链式调用那样容易不小心在其他分支多写一次响应。同时用try/catch统一处理异常，也能避免未捕获的Promise拒绝问题。

额外提醒（如果坚持用.then） #

检查你的路由代码，确保同一个请求只发送一次响应，比如下面这种写法就会触发错误：

// 错误示例：两次发送响应
app.get('/books', (req, res) => {
  res.send('正在加载书籍...'); // 第一次发送响应
  getBooks().then(books => {
    res.status(200).json(books); // 第二次发送，触发ERR_HTTP_HEADERS_SENT
  });
});

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