Express.js报错：Can't set headers after they are sent 问题求助

兄弟，这个随机蹦出来的错误我太熟了！Error: Can't set headers after they are sent说白了就是你的代码在已经给客户端返回完响应之后，又偷偷尝试修改响应头或者再次发响应了。之所以每5次刷新才出一次，肯定是因为某个逻辑分支只有在特定随机条件下才会触发重复响应的操作。

给你列几个最常见的坑和解决办法：

1. 路由/中间件里有多个响应调用，没终止流程 #

这是最容易踩的坑！比如你的代码可能长这样：

app.get('/index.html', (req, res) => {
  if (someRandomCondition) { // 这个条件随机成立，比如依赖缓存、请求参数啥的
    res.send('临时内容');
  }
  res.render('index'); // 不管上面有没有发响应，这里都会执行，直接触发错误
});

解决办法：每次发送响应后立刻加return终止后续代码，或者用else把逻辑拆分开：

app.get('/index.html', (req, res) => {
  if (someRandomCondition) {
    return res.send('临时内容'); // 加return，后面的render就不会执行了
  }
  res.render('index');
});

2. 异步操作没处理好，导致重复响应 #

比如你在异步回调/Promise里发了一次响应，外层又发了一次：

app.get('/index.html', (req, res) => {
  // 异步加载数据
  getHomePageData().then(data => {
    res.render('index', { data }); // 异步完成后发响应
  });
  res.send('加载中...'); // 先给客户端发了这个，后面异步完成又发一次，直接炸
});

解决办法：确保整个请求生命周期里只有一次响应输出，要么等异步操作完成后统一响应，要么用状态标记避免重复：

app.get('/index.html', (req, res) => {
  // 只在异步流程里处理响应，不管成功失败
  getHomePageData()
    .then(data => res.render('index', { data }))
    .catch(err => res.status(500).send('加载失败：' + err.message));
});

3. 中间件里调用next()后又发响应 #

有些中间件会在调用next()（让请求继续往下走）之后，又不小心执行了响应代码：

app.use((req, res, next) => {
  if (checkUserAuth(req)) {
    res.setHeader('X-Auth', 'valid');
    next(); // 让请求继续到路由处理
  }
  res.send('未授权'); // 如果checkUserAuth为true，next()之后这段代码还会执行，导致重复设置头
});

解决办法：调用next()的时候加return，切断后续代码的执行：

app.use((req, res, next) => {
  if (checkUserAuth(req)) {
    res.setHeader('X-Auth', 'valid');
    return next(); // 加return，后面的send就不会跑了
  }
  res.send('未授权');
});

排查小技巧 #

因为是随机出现，你可以在每个响应调用前加个日志，打印当前请求的标识或者触发条件，这样下次出错时就能定位到是哪两次响应冲突了：

app.get('/index.html', (req, res) => {
  const reqId = Date.now(); // 用时间戳当请求唯一标识
  console.log(`[${reqId}] 准备处理请求`);
  if (someRandomCondition) {
    console.log(`[${reqId}] 发送临时响应`);
    return res.send('临时内容');
  }
  console.log(`[${reqId}] 渲染首页`);
  res.render('index');
});

当错误出现时，看控制台日志，如果同一个reqId下面出现了两次发送响应的日志，那对应的代码就是问题所在！

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