Express仅发一次响应却报ERR_HTTP_HEADERS_SENT错误如何解决

1. 接口正常返回但服务端报错的原因 #

Error [ERR_HTTP_HEADERS_SENT] 错误触发在第二次及以后调用响应发送方法时，第一次调用 response.send() 时已经将完整的响应报文返回给客户端，Postman 会正常接收并展示这一次的返回结果。后续循环中其他异步查询完成后再次调用 response.send() 时，才会触发服务端的头部重复设置错误，该错误属于服务端运行时异常，不会影响已经发送完成的客户端响应。

2. 报错修复方案 #

你的代码存在两个核心问题：

• 对 categories 数组做遍历查询时，每个异步查询的回调里都会调用 response.send()，如果 categories 长度大于等于2，必然会多次发送响应
• Mongoose 查询混用了 await 和回调函数，代码执行顺序不可控

修复后代码： #

router.get('/api/', async function(request, response, next) {
  try {
    // 去掉冗余回调，统一用async/await处理异步逻辑
    const entries = await Entries.find({});
    // 一步完成分类ID提取+去重
    const categories = [...new Set(entries.map(entry => entry.category.id))];
    // 并行查询所有分类对应的条目，等待所有查询完成再处理
    const resultList = await Promise.all(
      categories.map(category => Entries.find({"category.id": category}))
    );
    // 仅调用一次响应发送方法，如需拍平嵌套数组可加.flat()
    response.send(resultList.flat());
  } catch (error) {
    // 统一错误处理，交给Express全局错误中间件
    console.error(error);
    next(error);
  }
})

3. 隐式重复发送响应的定位方法 #

Node.js 抛出的错误堆栈已经明确标注了问题代码位置：

at /Applications/MAMP/htdocs/xxxx-server/routes/entries.js:144:26

你可以直接定位到该路由文件的144行，也就是你写 response.send(result) 的位置。排查这类问题的通用逻辑：

• 搜索当前路由处理函数内所有会结束响应的方法调用：res.send()、res.json()、res.end()、res.redirect()、res.sendFile() 等
• 检查这些方法是否会被循环、异步回调、多分支逻辑重复执行

• 每个路由处理函数确保只有一个出口发送响应，不要在循环、可多次触发的异步回调里调用响应发送方法
• 尽量统一用 async/await 处理异步逻辑，避免回调嵌套导致的执行顺序不可控，搭配 try/catch 统一处理错误
• 如果需要批量执行异步操作，用 Promise.all() 等方法等待所有异步任务完成后，再统一返回结果

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