ERR_HTTP_HEADERS_SENT: Cannot set headers after they are sent to

在 Node.js 的 HTTP 服务器开发中，ERR_HTTP_HEADERS_SENT: Cannot set headers after they are sent to the client at ServerResponse.setHeader 是一个常见的错误提示。该错误表明服务器尝试在响应头已发送给客户端之后，再次设置响应头，这是不被允许的操作。

错误含义

在 HTTP 协议中，服务器向客户端发送响应时，首先发送响应头，然后发送响应主体。一旦响应头发送完毕，服务器就不能再修改或添加新的响应头。如果在响应头发送后尝试再次设置响应头，Node.js 会抛出 ERR_HTTP_HEADERS_SENT 错误。该错误的完整信息为：Cannot set headers after they are sent to the client at ServerResponse.setHeader，即在响应头已发送给客户端后，无法设置响应头。

错误原因

该错误通常由以下原因引起：

1. 多次发送响应：在处理同一个请求时，服务器代码中多次调用了 res.send()、res.json() 或 res.end() 等方法，导致尝试多次发送响应。

2. 异步操作中的错误处理：在异步操作（如数据库查询、文件读取等）中，未正确处理错误或未在错误发生时终止后续操作，导致在错误处理后仍尝试发送响应。

3. 逻辑错误：代码逻辑中存在分支未正确返回，导致在某些情况下，响应被发送多次。

示例分析

以下是一个可能导致该错误的示例：

app.get('/example', (req, res) => {
  if (!req.query.name) {
    res.status(400).send('Name is required');
  }
  res.send(`Hello, ${req.query.name}`);
});

在上述代码中，如果 req.query.name 不存在，服务器会发送状态码为 400 的响应，并提示“Name is required”。然而，代码在此之后没有终止函数的执行，继续执行 res.send()，这会导致尝试再次发送响应，从而引发 ERR_HTTP_HEADERS_SENT 错误。

解决方法

为避免该错误，需要确保在发送响应后终止函数的执行，防止后续代码再次发送响应。可以通过在发送响应后使用 return 语句来实现：

app.get('/example', (req, res) => {
  if (!req.query.name) {
    res.status(400).send('Name is required');
    return;
  }
  res.send(`Hello, ${req.query.name}`);
});

在上述修改后的代码中，当 req.query.name 不存在时，服务器发送状态码为 400 的响应，并提示“Name is required”，然后通过 return 语句终止函数的执行，避免了后续代码的执行，从而防止了 ERR_HTTP_HEADERS_SENT 错误的发生。

异步操作中的注意事项

在处理异步操作时，需要特别注意错误处理和响应的发送顺序。以下是一个示例，展示如何在异步操作中正确处理响应：

app.get('/data', (req, res) => {
  database.query('SELECT * FROM users', (err, result) => {
    if (err) {
      res.status(500).send('Database error');
      return;
    }
    res.json(result);
  });
});

在上述代码中，首先执行数据库查询操作。如果查询过程中发生错误，服务器发送状态码为 500 的响应，并提示“Database error”，然后通过 return 语句终止函数的执行，避免了后续代码的执行。如果查询成功，服务器将查询结果以 JSON 格式发送给客户端。

总结

ERR_HTTP_HEADERS_SENT 错误通常是由于在响应头已发送后再次尝试设置响应头引起的。为避免该错误，需要确保在发送响应后终止函数的执行，防止后续代码再次发送响应。在处理异步操作时，需要特别注意错误处理和响应的发送顺序，确保在错误发生时及时发送响应并终止后续操作。