NodeJS异步函数中res.writeHead(302)无法重定向问题排查

核心可能原因及排查步骤 #

• 检查异步流程中的响应发送时机
  异步操作（比如client.query）如果出现错误，或者在重定向之前已经通过res.write、res.send、res.end发送了部分响应内容，会导致后续的res.writeHead(302)无法修改响应头——HTTP协议要求响应头必须在响应体之前发送，一旦发送了响应体，头就不能再修改了。
  排查方式：在client.query的回调或Promise处理中添加完整的错误捕获，示例如下：

  // 回调式写法
  client.query('SELECT * FROM users WHERE username = $1', [username], (err, result) => {
    if (err) {
      console.error(err);
      res.writeHead(500);
      res.end('Server Error');
      return;
    }
    // 验证通过后执行重定向
    res.writeHead(302, { Location: '/dashboard' });
    res.end();
  });
  

  若使用async/await：

  async function handleLoginReq(req, res) {
    try {
      const result = await client.query('SELECT * FROM users WHERE username = $1', [username]);
      // 用户验证逻辑
      res.writeHead(302, { Location: '/dashboard' });
      res.end();
    } catch (err) {
      console.error(err);
      res.writeHead(500);
      res.end('Server Error');
    }
  }
  

• 确认重定向路径的正确性
  确保Location头使用绝对路径（比如/dashboard），而非相对路径（比如dashboard）。浏览器对POST请求的重定向处理中，相对路径可能被解析为相对于当前登录页面的路径，导致跳转到错误地址（如/login/dashboard），最终因页面不存在或权限问题跳转回登录页。

• 检查分支逻辑的响应完整性
  若在client.query的处理逻辑中存在分支判断（比如用户验证失败），要确保每个分支都有明确的响应结束逻辑，且用return终止后续代码执行。错误示例：

  // 错误：验证失败时未终止后续代码
  client.query(..., (err, result) => {
    if (result.rows.length === 0) {
      res.write('用户名或密码错误');
      res.end();
      // 未添加return，后续重定向代码仍会执行，但此时响应已结束
    }
    res.writeHead(302, { Location: '/dashboard' });
    res.end();
  });
  

  修正方式是在验证失败的分支添加return，避免后续代码执行。

• 确认异步函数的路由处理正确
  若handleLoginReq是异步函数，需在路由中正确处理异步错误，避免未捕获异常中断请求：

  // 路由处理示例（以Express为例）
  app.post('/login', async (req, res) => {
    try {
      await handleLoginReq(req, res);
    } catch (err) {
      console.error(err);
      res.writeHead(500);
      res.end('Server Error');
    }
  });
  

关键验证点 #

打开浏览器开发者工具（F12）的网络标签，查看登录请求的响应：

• 确认状态码为302
• 确认Location头存在且路径正确
• 若状态码不是302，说明重定向代码未执行，或之前已发送其他响应头

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