NodeJS开发REST API遇'Can't set headers after they are sent'错误求助

嘿，作为天天和Express、MongoDB打交道的开发者，这个错误我可太熟悉了！它说白了就是你的代码多次尝试给客户端发送HTTP响应了——HTTP协议规定一个请求只能对应一个响应，重复发送就会触发这个报错。结合你说的场景（带x-auth头访问/node/me，中间件查询MongoDB找用户），我给你梳理几个最常见的坑和解决办法：

1. 异步查询的逻辑分支没正确终止 #

MongoDB的查询是异步操作，很多新手容易在回调或者async/await里忽略分支的终止，导致代码同时执行了"发响应"和"调用next()"，或者多次发响应。

错误示例（踩坑点） #

// 中间件错误写法：没有用return终止分支，导致后续代码继续执行
app.use('/node/me', (req, res, next) => {
  const xAuth = req.headers['x-auth'];
  User.findOne({ token: xAuth }, (err, user) => {
    if (err) {
      res.status(401).send(err); // 这里发了响应，但没return，后面的代码还会跑
    }
    if (!user) {
      res.status(404).send('用户不存在'); // 如果err和!user同时触发，这里会第二次发响应
    }
    req.user = user;
    next(); // 不管前面有没有发响应，都会调用next，让路由继续执行，再发一次响应
  });
});

正确写法（两种方式） #

方式一：用return终止后续逻辑

app.use('/node/me', (req, res, next) => {
  const xAuth = req.headers['x-auth'];
  User.findOne({ token: xAuth }, (err, user) => {
    if (err) {
      return res.status(401).send(err); // return后，后面的代码不会执行
    }
    if (!user) {
      return res.status(404).send('用户不存在');
    }
    req.user = user;
    next(); // 只有前面都没问题才会走到这里
  });
});

方式二：用async/await简化异步逻辑（更推荐，避免回调嵌套）

app.use('/node/me', async (req, res, next) => {
  try {
    const xAuth = req.headers['x-auth'];
    const user = await User.findOne({ token: xAuth });
    
    if (!user) {
      return res.status(404).send('用户不存在');
    }
    
    req.user = user;
    next();
  } catch (err) {
    return res.status(401).send(err); // 捕获查询错误，发响应后终止
  }
});

2. 路由处理函数重复发送响应 #

如果你的/node/me路由处理函数里，在中间件已经发送响应的情况下，还继续执行并发送响应，也会触发错误。比如中间件已经因为token无效发了401响应，但因为没return，路由还是执行了res.send(req.user)，这就会重复发响应。

检查点 #

确保路由处理函数只在中间件成功传递req.user时才执行：

app.get('/node/me', (req, res) => {
  // 这里的req.user是中间件传递过来的，只有中间件没发响应时才会走到这里
  res.send(req.user);
});

3. JWT验证环节的隐藏问题 #

如果你的JWT验证是单独的中间件，也要检查它的逻辑：是不是在验证失败时发送了响应，但没return，导致后续的用户查询中间件继续执行，又发了一次响应。

快速排查技巧 #

可以在每个res.send()/res.json()前面加console.log('发送响应：xxx')，然后测试接口，看控制台里是不是打印了多次发送响应的日志，这样就能快速定位到重复发送的代码位置。

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