在async代码块中调用res.sendStatus()报错，如何正确返回成功状态码？

嘿，这个错误我太熟悉了！咱们先拆解下背后的原因，再给你一套靠谱的解决办法～

Unhandled rejection Error: Can't set headers after they are sent这个报错的核心问题很简单：你给同一个HTTP请求发送了多次响应。比如在你的async代码块里，可能先执行了res.send()或者res.status()这类操作，后面又不小心触发了另一个修改响应头或发送响应的逻辑，导致Node.js的HTTP模块报错——毕竟一个请求只能有一次完整的响应。

假设你是在Express这类框架里写的代码，我给你举个典型的错误示例和修正后的版本：

错误示例（触发报错的常见场景） #

app.get('/api/get-data', async (req, res) => {
  try {
    const result = await fetchDataFromDB();
    // 第一次发送响应
    res.send('获取数据成功');
    // 后面不小心又执行了一次响应操作
    res.status(200).end(); // 这里直接触发报错！
  } catch (err) {
    res.status(500).send('服务器出错');
  }
});

修正后的正确写法 #

app.get('/api/get-data', async (req, res) => {
  try {
    const result = await fetchDataFromDB();
    // 发送成功响应后，用return终止后续代码执行
    return res.status(200).json({
      success: true,
      message: '请求处理成功',
      data: result
    });
  } catch (err) {
    // 错误场景同样只发送一次响应，并用return结束
    return res.status(500).json({
      success: false,
      message: '请求处理失败',
      error: err.message
    });
  }
});

• 一个请求只发一次响应：发送响应后立刻用return中断函数执行，避免后续逻辑误操作response对象。
• 统一响应格式：不管成功还是失败，用res.status().json()这种方式明确状态码和响应内容，既清晰又能避免重复发送。
• 分支场景要严谨：如果代码里有多个if/else分支，要确保每个分支都只发送一次响应，不要遗漏或重复。

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