开发Discord机器人后台时授权页面出现ERR_HTTP_HEADERS_SENT错误

ERR_HTTP_HEADERS_SENT本质就是同一个HTTP请求中被多次发送响应，哪怕你移除了JWT、redirect相关代码，大概率是代码里还有隐藏的重复响应逻辑，按下面的方向排查：

• 检查异步流程的响应触发：比如async函数里await前后、Promise的then/catch分支里，有没有不小心写了两次res相关方法。举个典型错误例子：

app.get('/auth', async (req, res) => {
  try {
    const user = await getDiscordUser(req.query.code);
    res.send('获取用户成功'); // 第一次响应
    const token = jwt.sign({ uid: user.id }, 'your-secret');
    res.cookie('auth-token', token);
    res.redirect('/panel'); // 第二次响应，直接触发错误
  } catch (err) {
    res.status(500).send('出错了');
  }
});

• 确认条件分支里的流程终止：如果在if/else分支里发送了响应，一定要加return阻止后续代码执行。比如：

// 错误写法：没加return，后续代码继续执行发响应
if (!req.query.code) {
  res.status(400).send('缺少授权码');
}
// 下面的代码会再次触发响应
const token = jwt.sign(/* ... */);
res.redirect('/panel');

// 正确写法
if (!req.query.code) {
  res.status(400).send('缺少授权码');
  return; // 终止后续流程
}
const token = jwt.sign(/* ... */);
res.redirect('/panel');

• 排查中间件或嵌套路由：如果你的授权路由挂了多个中间件，检查某个中间件是不是已经发送了响应（比如权限校验中间件直接res.send了错误，当前路由又继续处理）。可以在中间件里用res.headersSent判断是否已经发送过响应：

// 中间件示例
app.use((req, res, next) => {
  if (!req.session) {
    if (!res.headersSent) {
      res.status(401).send('未登录');
    }
    return;
  }
  next();
});

• 检查第三方工具的默认行为：比如你用的Discord OAuth SDK，有没有内部自动发送响应的配置？比如某些库会在获取token后自动redirect，你又手动加了一次，就会重复。

实操建议：把当前授权路由的代码精简到最简，只保留最基础的响应逻辑，比如只写res.redirect('/panel')，看是否还报错。如果不报错，再逐步加回JWT、用户校验等代码，每加一段就测试，定位到触发错误的代码块。

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