Node.js+Express+MongoDB后端开发遇ERR_HTTP_HEADERS_SENT报错如何解决
报错核心原因
ERR_HTTP_HEADERS_SENT 本质是同一个请求周期内向客户端发送了多次响应。HTTP协议规定,响应头一旦推送给客户端之后就不能再修改、不能再重复发送响应内容,只要连续调用两次res.send()、res.json()这类生成HTTP响应的方法,就会直接触发这个终端报错。
代码中存在的两个明确问题
- 所有错误判断分支缺少终止逻辑:所有控制器里的错误处理代码都写了
if (err) res.send(err),但执行完错误响应之后,函数没有中断,会继续向下执行后面的正常数据返回逻辑。比如查询报错时,先把错误信息返回给客户端,紧接着又执行res.json(查询结果),直接触发重复响应的报错。 - createATask函数存在低级笔误:代码里写的
if (err);在if判断后面直接加了分号,相当于这个if分支没有绑定任何实际执行代码。不管有没有保存错误,都会连续执行res.send(err)和res.json(task)两个响应方法,哪怕没有任何数据库操作异常,只要请求走到这个回调就必然报错。
修复方案
只需要在所有错误响应分支后加上return关键字,终止函数后续执行,就能彻底解决这个问题,修正后的可运行代码如下:
'use strict'; var mongoose = require('mongoose'), Task = mongoose.model('Tasks'); exports.listAllTasks = function (req, res) { Task.find({}, function (err, task) { // 错误分支返回后立即终止函数 if (err) return res.send(err); res.json(task); }); }; exports.createATask = function (req, res) { var newTask = new Task(req.body); newTask.save(function (err, task) { // 删掉if后多余的分号,加上return if (err) return res.send(err); res.json(task); }); }; exports.readATask = function (req, res) { Task.findById(req.params.taskId, function (err, task) { if (err) return res.send(err); res.json(task); }); }; exports.updateATask = function (req, res) { Task.findOneAndUpdate( { _id: req.params.taskId }, req.body, { new: true }, function (err, task) { if (err) return res.send(err); res.json(task); } ); }; exports.deleteATask = function (req, res) { Task.deleteMany( { _id: req.params.taskId }, function (err, task) { if (err) return res.send(err); res.json({ message: 'Task successfully deleted' }); } ); };
日常排查提示
- 写条件分支时一定要检查句尾是不是不小心加了多余的分号,JavaScript语法里的分号会直接截断当前语句的作用范围,很多隐蔽逻辑bug都是这类笔误导致的。
- 除了加return之外,也可以用
if/else结构把错误处理逻辑和正常返回逻辑做物理隔离,从代码结构上避免触发重复响应。
内容的提问来源于stack exchange,提问作者Rosie
相关产品推荐
相关产品推荐

