错误：在将标头发送到客户端后无法设置标头

此问答中的某些答案是错误的。接受的答案也不是很“实用”，所以我想发布一个用更简单的术语解释事情的答案。我的回答将涵盖我一遍又一遍看到的 99% 的错误。对于错误背后的实际原因，请查看接受的答案。

HTTP 使用一个循环，每个请求需要一个响应。当客户端发送一个请求（例如 POST 或 GET）时，服务器应该只向它发送一个响应。

此错误消息：

错误：发送后无法设置标头。

通常在您为一个请求发送多个响应时发生。确保每个请求只调用一次以下函数：

res.json()

res.send()

res.redirect()

res.render()

（还有一些很少使用的，检查接受的答案）

调用这些 res 函数时，路由回调不会返回。它将继续运行，直到它到达函数的末尾或返回语句。如果您想在发送响应时返回，您可以这样做：return res.send()。

以这段代码为例：

app.post('/api/route1', function(req, res) {
  console.log('this ran');
  res.status(200).json({ message: 'ok' });
  console.log('this ran too');
  res.status(200).json({ message: 'ok' });
}

当 POST 请求发送到 /api/route1 时，它将运行回调中的每一行。将抛出 Can't set headers after they are sent 错误消息，因为 res.json() 被调用了两次，这意味着发送了两个响应。

每个请求只能发送一个响应！

上面代码示例中的错误很明显。一个更典型的问题是当您有多个分支时：

app.get('/api/company/:companyId', function(req, res) {
  const { companyId } = req.params;
  Company.findById(companyId).exec((err, company) => {
      if (err) {
        res.status(500).json(err);
      } else if (!company) {
        res.status(404).json();      // This runs.
      }
      res.status(200).json(company); // This runs as well.
    });
}

带有附加回调的这条路线在数据库中找到一家公司。查询不存在的公司时，我们将进入 else if 分支并发送 404 响应。之后，我们将继续执行下一个也发送响应的语句。现在我们已经发送了两个响应，并且会出现错误消息。我们可以通过确保只发送一个响应来修复此代码：

.exec((err, company) => {
  if (err) {
    res.status(500).json(err);
  } else if (!company) {
    res.status(404).json();         // Only this runs.
  } else {
    res.status(200).json(company);
  }
});

或者在发送响应时返回：

.exec((err, company) => {
  if (err) {
    return res.status(500).json(err);
  } else if (!company) {
    return res.status(404).json();  // Only this runs.
  }
  return res.status(200).json(company);
});

一个大罪人是异步函数。以 this 问题中的函数为例：

article.save(function(err, doc1) {
  if (err) {
    res.send(err);
  } else {
    User.findOneAndUpdate({ _id: req.user._id }, { $push: { article: doc._id } })
    .exec(function(err, doc2) {
      if (err) res.send(err);
      else     res.json(doc2);  // Will be called second.
    })

    res.json(doc1);             // Will be called first.
  }
});

这里我们在代码示例中有一个异步函数 (findOneAndUpdate())。如果没有错误 (err)，将调用 findOneAndUpdate()。因为这个函数是异步的，所以 res.json(doc1) 将被立即调用。假设 findOneAndUpdate() 中没有错误。然后将调用 else 中的 res.json(doc2)。现在已经发送了两个响应，并且出现了 Can't set headers 错误消息。

在这种情况下，解决方法是删除 res.json(doc1)。要将两个文档都发送回客户端，else 中的 res.json() 可以写为 res.json({ article: doc1, user: doc2 })。

---

我遇到了同样的问题，并意识到这是因为我在没有 return 语句的情况下调用了 res.redirect，因此随后也立即调用了 next 函数：

auth.annonymousOnly = function(req, res, next) {
    if (req.user) res.redirect('/');
    next();
};

应该是：

auth.annonymousOnly = function(req, res, next) {
    if (req.user) return res.redirect('/');
    next();
};

---

很多人都遇到了这个错误。这与异步处理令人困惑。很可能您的某些代码在第一个滴答声中设置标题，然后您在未来的滴答声中运行异步回调。在这期间，响应标头被发送，但随后的标头（如 30X 重定向）尝试添加额外的标头，但为时已晚，因为响应标头已经传输。

我不确定究竟是什么导致了您的错误，但将任何回调视为潜在的调查领域。

简化代码的一个简单技巧。去掉 app.configure() 并直接在您的顶级范围内调用 app.use。

另请参阅 everyauth 模块，该模块执行 Facebook 和十几个其他第三方身份验证提供程序。

---

在 RND 之后自行发现错误：

1）我的错误代码：

return res.sendStatus(200).json({ data: result });

2）我的成功代码

return res.status(200).json({ data: result });

不同之处在于我使用了 sendStatus() 而不是 status()。

---

我对这个问题一头雾水，这是由于处理回调时的粗心错误而发生的。未返回的回调会导致响应被设置两次。！

我的程序有一个验证请求和查询数据库的代码。验证是否存在错误后，我用验证错误回调 index.js 。如果验证通过，它将继续并以成功/失败命中数据库。

    var error = validateRequestDetails("create",queryReq);
    if (error)
        callback(error, null);
   else
    some code 
    callback(null, success);

发生的事情是：万一验证失败，回调被调用并响应被设置。但没有归还。所以它仍然继续该方法转到 db 并点击 success/failure 。它再次调用相同的回调，导致现在设置两次响应。

所以解决方案很简单，一旦发生错误，您需要“返回”回调，以便该方法不会继续执行，因此设置一次响应对象

  var error = validateRequestDetails("create",queryReq);
    if (error)
        callback(error, null);
        return;
    else
       some code 
       callback(null, success);

---

当您在发送响应后传递语句时，您会遇到这种类型的错误。

例如：

res.send("something response");
console.log("jhgfjhgsdhgfsdf");
console.log("sdgsdfhdgfdhgsdf");
res.send("sopmething response");

将导致您看到的错误，因为一旦发送响应，将不会执行以下 res.send。

如果你想做任何事情，你应该在发送响应之前做。

---

当您发送 2 个响应时会发生此错误。例如 ：

if(condition A)
{ 

      res.render('Profile', {client:client_});

}

if (condition B){

      res.render('Profile', {client:client_});
    }
  }

想象一下，如果由于某种原因条件 A 和 B 为真，那么在第二个 render 中，您将收到该错误

---

有时，当您尝试在 res.end 或 res.send 之后调用 next() 函数时，您可能会收到此错误，如果您在函数中 res.send 或 res.end 之后有 next() ，请尝试删除。注意：这里的 next() 表示在用您的响应（即 res.send 或 res.end）响应客户端之后，您仍在尝试执行一些代码以再次响应，因此这是不合法的。

例子 ：

router.get('/',function (req,res,next){
     res.send("request received");
     next(); // this will give you the above exception 
});

从上面的函数中删除 next() ，它将起作用。

---

如果您使用回调函数，请在 err 块之后使用 return。这是可能发生此错误的场景之一。

userModel.createUser(data, function(err, data) {
    if(err) {
      res.status = 422
      res.json(err)
      return // without this return the error can happen.
    }
    return res.json(data)
  })

在节点版本 v10.16.0 和 express 4.16.4 上测试

---

我只需添加 return 关键字，例如：return res.redirect("/great");，它就起作用了！

---

还有其他原因导致此错误，并且是当您没有在 res.send、res.json 等前面添加 return 关键字时......

---

在我的情况下，导致问题的是 304 响应（缓存）。

最简单的解决方案：

app.disable('etag');

如果您想要更多控制权，请在此处替代解决方案：

http://vlasenko.org/2011/10/12/expressconnect-static-set-last-modified-to-now-to-avoid-304-not-modified/

---

对于任何人来说，其他解决方案都没有帮助，在我的情况下，这体现在处理图像上传但没有处理超时的路由上，因此如果上传时间过长并且超时，当回调被触发时发送超时响应后，调用 res.send() 会导致崩溃，因为标头已设置为考虑超时。

这很容易通过设置一个非常短的超时并用相当大的图像击中路线来重现，每次都会重现崩溃。

---

在我的情况下，当我没有在我的 React 组件的 componentWillUnmount 回调中取消订阅频道时，React 和 postal.js 就会发生这种情况。

---

请检查您的代码是否为单个请求返回多个 res.send() 语句。就像我遇到这个问题时一样......

我在我的 restify 节点应用程序中遇到了这个问题。错误在于

switch (status) {
    case -1:
      res.send(400);
    case 0:
      res.send(200);
    default:
      res.send(500);
}

我在不写中断的情况下使用 switch 处理各种情况。对switch case不太熟悉的人都知道，不用break，return关键字。 case 下的代码和它的下一行无论如何都会被执行。所以即使我想发送单个 res.send，由于这个错误它返回了多个 res.send 语句，这提示

错误：发送到客户端后无法设置标头。

通过在每个 res.send() 方法（如 return res.send(200)

switch (status) {
    case -1:
      res.send(400);
      break;
    case 0:
      res.send(200);
      break;
    default:
      res.send(500);
      break;
}

---

就靠这个了。您可以通过此函数传递响应：

app.use(function(req,res,next){
  var _send = res.send;
  var sent = false;
  res.send = function(data){
    if(sent) return;
    _send.bind(res)(data);
    sent = true;
};
  next();
});

---

当响应被传递给客户端并且您再次尝试给出响应时，就会发生这种情况。您必须检查您的代码是否在某处再次向客户端返回响应，这会导致此错误。当您想返回时，检查并返回响应一次。

---

请在您的 app.get 中搜索 res.send("your result"); 之前是否未设置状态

我刚刚删除：

res.sendStatus(200);

并且响应在那之后起作用！

res.send("your result");

---

较新版本的 Node 支持 res.headersSent 布尔表达式。您可以使用它来验证您是否已经发送了响应：

if (!res.headersSent) // if doesn't sent yet
    res.status(200).send({ "message": "This is a message" })

笔记！虽然这有效并回答了问题，但这不是解决问题的正确方法，不推荐！

多次发送响应表明您的代码中有问题需要修复（这与在您的函数中一个接一个地使用两个返回语句相同。这是一个错误）。

---

添加这个中间件，它会工作

app.use(function(req,res,next){
 var _send = res.send;
var sent = false;
res.send = function(data){
    if(sent) return;
    _send.bind(res)(data);
    sent = true;
};
next();
});

---

如果您没有从上面得到帮助：对于新手这个错误背后的原因是多次发送请求，让我们从某些情况下理解：- 1.`

module.exports = (req,res,next)=>{
        try{
           const decoded  = jwt.verify(req.body.token,"secret");
           req.userData = decoded;
           next();
        }catch(error){
            return res.status(401).json({message:'Auth failed'});
        }
        next();   
        }

` 在上面调用 next() 两次会引发错误

router.delete('/:orderId', (req, res, next) => { Order.remove({_id:req.params.orderId},(err,data)=>{ if(err){ **res .status(500).json(err);** }else{ res.status(200).json(data); } *res.status(200).json(data);* }) })

这里响应是发送两次检查您是否已经发送了响应

---

这很可能更像是一个节点的事情，99% 的时间它是一个双重回调导致你响应两次，或者 next()ing 两次等等，该死的肯定。它解决了我在循环中使用 next() 的问题。从循环中删除 next() 或停止多次调用它。

---

如果您在一次 api 调用中使用了两个 res.end() 函数，则会显示此错误

例如

  app.post("/auth", function (request, res) {
    var username = request.body.username;
    var password = request.body.password;
    if (username && password) {
      let sql =
        "SELECT username, worker_name, worker_surname, id FROM workers where username = ? AND password=?";
      con.query(sql, [username, password], function (error, results, fields) {
        if (results.length > 0) {
          res.status(200).send(results);
          res.end();
  
        }
        res.status(404).send("Incorrect Username and/or Password!");
      });
    } else {
      res.send("Please enter Username and Password!");
    }
    res.end();

  });

---

问题出在 /auth/facebook 路由中，以便于理解，一旦您已经从客户端发送了响应，则不得为下一个后继块设置以下任何其他功能，这也与 JavaScript 的同步有关，

为了深入理解，它看起来像这段代码；

async function getRequest(){
   let data = await API.get();
   return data;
   let json = data.json(); // will not read this line
}

在您的情况下，console.log("ok cool."); 和 console.log(res['req']['session']) 必须放在 res.redirect("/great") 之前

https://i.stack.imgur.com/tik61.png

希望它有意义，欢迎:)

---

当我尝试在循环函数中发送响应时，我遇到了类似的错误。简单的解决方案是移动

res.send('发送回复');

退出循环，因为您只能发送一次响应标头。

https://www.tutorialspoint.com/nodejs/nodejs_response_object.htm

---

检查你的代码。对我来说，我在同一个 if 语句中使用了 res.status 两次。第一个设置标题状态，第二个尝试更改它，这导致了问题。

---

在 Typescript 中，我的问题是收到消息后我没有关闭 websocket 连接。

WebSocket.on("message", (data) => {
    receivedMessage = true;
    doSomething(data);
    localSocket.close(); //This close the connection, allowing 
});

---

我在嵌套 Promise 时遇到了这个问题。 Promise 中的 Promise 会返回 200 给服务器，但是外部 Promise 的 catch 语句会返回 500。一旦我解决了这个问题，问题就消失了。

---