错误:将标头发送到客户端后无法设置标头Node.js/Express 响应方法的完整列表以及何时必须调用它们:

2022-08-29 22:07:33

我对Node很陌生.js我遇到了一些问题。

我使用的是 Node.js 4.10 和 Express 2.4.3。

当我尝试访问 http://127.0.0.1:8888/auth/facebook 时,我会被重定向到 http://127.0.0.1:8888/auth/facebook_callback

然后,我收到以下错误:

Error: Can't render headers after they are sent to the client.
    at ServerResponse.<anonymous> (http.js:573:11)
    at ServerResponse._renderHeaders (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/patch.js:64:25)
    at ServerResponse.writeHead (http.js:813:20)
    at /home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect-auth/lib/auth.strategies/facebook.js:28:15
    at /home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect-auth/lib/index.js:113:13
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect-auth/lib/strategyExecutor.js:45:39)
    at [object Object].pass (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect-auth/lib/authExecutionScope.js:32:3)
    at [object Object].halt (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect-auth/lib/authExecutionScope.js:29:8)
    at [object Object].redirect (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect-auth/lib/authExecutionScope.js:16:8)
    at [object Object].<anonymous> (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect-auth/lib/auth.strategies/facebook.js:77:15)
Error: Can't set headers after they are sent.
    at ServerResponse.<anonymous> (http.js:527:11)
    at ServerResponse.setHeader (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/patch.js:50:20)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:162:13)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:195:11)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:150:23)
    at param (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/router.js:189:13)
    at pass (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/router.js:191:10)
    at Object.router [as handle] (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/router.js:197:6)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:198:15)
    at Object.auth [as handle] (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect-auth/lib/index.js:153:7)
Error: Can't set headers after they are sent.
    at ServerResponse.<anonymous> (http.js:527:11)
    at ServerResponse.setHeader (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/patch.js:50:20)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:162:13)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:207:9)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:150:23)
    at param (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/router.js:189:13)
    at pass (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/router.js:191:10)
    at Object.router [as handle] (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/router.js:197:6)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:198:15)
    at Object.auth [as handle] (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect-auth/lib/index.js:153:7)
Error: Can't set headers after they are sent.
    at ServerResponse.<anonymous> (http.js:527:11)
    at ServerResponse.setHeader (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/patch.js:50:20)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:162:13)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:150:23)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:207:9)
    at Object.auth [as handle] (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect-auth/lib/index.js:153:7)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:198:15)
    at HTTPServer.handle (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:211:3)
    at Object.handle (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:105:14)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:198:15)
Error: Can't set headers after they are sent.
    at ServerResponse.<anonymous> (http.js:527:11)
    at ServerResponse.setHeader (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/patch.js:50:20)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:162:13)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:150:23)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:207:9)
    at HTTPServer.handle (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:211:3)
    at Object.handle (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:105:14)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:198:15)
    at /home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/session.js:323:9
    at /home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/session.js:338:9

node.js:134
        throw e; // process.nextTick error, or 'error' event on first tick
        ^
Error: Can't set headers after they are sent.
    at ServerResponse.<anonymous> (http.js:527:11)
    at ServerResponse.setHeader (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/patch.js:50:20)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:162:13)
    at next (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/http.js:207:9)
    at /home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/session.js:323:9
    at /home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/session.js:338:9
    at Array.<anonymous> (/home/eugene/public_html/all_things_node/projects/fb2/node_modules/connect/lib/middleware/session/memory.js:57:7)
    at EventEmitter._tickCallback (node.js:126:26)

以下是我的代码:

var fbId= "XXX";
var fbSecret= "XXXXXX";
var fbCallbackAddress= "http://127.0.0.1:8888/auth/facebook_callback"

var cookieSecret = "node";     // enter a random hash for security

var express= require('express');
var auth = require('connect-auth')
var app = express.createServer();


app.configure(function(){
    app.use(express.bodyParser());
    app.use(express.methodOverride());
    app.use(express.cookieParser());
    app.use(express.session({secret: cookieSecret}));
    app.use(auth([
        auth.Facebook({
            appId : fbId,
            appSecret: fbSecret,
            callback: fbCallbackAddress,
            scope: 'offline_access,email,user_about_me,user_activities,manage_pages,publish_stream',
            failedUri: '/noauth'
        })
    ]));
    app.use(app.router);
});


app.get('/auth/facebook', function(req, res) {
  req.authenticate("facebook", function(error, authenticated) {
    if (authenticated) {
      res.redirect("/great");
      console.log("ok cool.");
      console.log(res['req']['session']);
    }
  });
});

app.get('/noauth', function(req, res) {
  console.log('Authentication Failed');
  res.send('Authentication Failed');
});

app.get('/great', function( req, res) {
  res.send('Supercoolstuff');
});

app.listen(8888);

我可以知道我的代码出了什么问题吗?


答案 1

Express 中的对象是 Node.js 的 http 的子类。ServerResponse读取 http.js源)。您可以根据需要随时呼叫,直到您呼叫 。之后,标头被烘烤,您只能调用 ,最后。resres.setHeader(name, value)res.writeHead(statusCode)writeHeadres.write(data)res.end(data)

错误“错误:发送后无法设置标头”表示您已经处于“正文”或“已完成”状态,但某些函数尝试设置标头或状态代码。当您看到此错误时,请尝试查找在已经写入某些正文后尝试发送标头的任何内容。例如,查找意外调用两次的回调,或在发送正文后发生的任何错误。

在您的情况下,您调用 了 ,导致响应变为“已完成”。然后你的代码抛出了一个错误( is )。由于错误发生在您的实际(而不是回调中),Connect能够捕获它,然后尝试发送500错误页面。但是由于标头已经发送,因此Node.js抛出了您看到的错误。res.redirect()res.reqnullfunction(req, res, next)setHeader

Node.js/Express 响应方法的完整列表以及何时必须调用它们:

响应必须在头部中并保持在头部

  1. res.writeContinue()
  2. res.statusCode = 404
  3. res.setHeader(name, value)
  4. res.getHeader(name)
  5. res.removeHeader(name)
  6. res.header(key[, val]) (仅限 Express)
  7. res.charset = 'utf-8'(仅限 Express;仅影响特定于 Express 的方法)
  8. res.contentType(type) (仅限 Express)

响应必须在头部并成为身体

  1. res.writeHead(statusCode, [reasonPhrase], [headers])

响应可以在头部/身体中,并保留在身体中:

  1. res.write(chunk, encoding='utf8')

响应可以在头部/身体中的任何一个中,并变为“已完成”

  1. res.end([data], [encoding])

响应可以在头部/身体中的任何一个中,并保持其当前状态:

  1. res.addTrailers(headers)

响应必须在“头部”中并变为“已完成”

  1. return next([err])(仅限连接/高速)
  2. 中间件中的任何异常(仅限连接/高速)function(req, res, next)
  3. res.send(body|status[, headers|status[, status]]) (仅限 Express)
  4. res.attachment(文件名)(仅限 Express)
  5. res.sendfile(path[, options[, callback]]) (仅限 Express)
  6. res.json(obj[, headers|status[, status]]) (仅限 Express)
  7. res.redirect(url[, status]) (仅限 Express)
  8. res.cookie(name, val[, options]) (仅限 Express)
  9. res.clearCookie(name[, options]) (Express only)
  10. res.render(view[, options[, fn]]) (仅限 Express)
  11. res.partial(view[, options]) (Express only)

答案 2

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


HTTP 使用一个循环,该周期要求每个请求一个响应。当客户端发送请求(例如POST或GET)时,服务器应该只向它发送一个响应。

此错误消息:

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

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

  • res.json()
  • res.send()
  • res.redirect()
  • res.render()

(还有几个很少使用的答案,检查接受的答案)

调用这些 res 函数时,路由回调将不会返回。它将继续运行,直到它到达函数或 return 语句的末尾。如果要在发送响应时返回,可以按如下方式进行:.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 时,它将运行回调中的每一行。发送标头后无法设置标头错误消息将被引发,因为调用了两次,这意味着发送了两个响应。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.
    });
}

此附加回调的路由在数据库中查找公司。当对不存在的公司进行查询时,我们将进入分支机构并发送404响应。之后,我们将继续下一个声明,该声明也发送响应。现在我们已经发送了两个响应,并且将出现错误消息。我们可以通过确保只发送一个响应来修复此代码:else if

.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);
});

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

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.
  }
});

这里,我们在代码示例中有一个异步函数 ()。如果没有错误(),将调用。由于此函数是异步的,因此将立即调用。假定 中没有错误。然后调用 in 中的 。现在已发送两个响应,并且出现“无法设置标头”错误消息。findOneAndUpdate()errfindOneAndUpdate()res.json(doc1)findOneAndUpdate()res.json(doc2)else

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