Node.js/Express.js登录注册后重定向失败及ERR_HTTP_HEADERS_SENT报错排查

问题核心原因 #

你遇到的两个问题（重定向失效、Cannot set headers after they are sent to the client错误）本质是同一个原因：在单个HTTP请求中，你尝试发送了两次响应。

HTTP协议规定，一个请求只能对应一个完整的响应。你的代码中先调用了res.json()返回JSON数据，这个操作已经向客户端发送了响应头和响应体，后续的res.redirect()会试图再次修改响应头（重定向需要设置Location头），此时响应已经结束，自然会触发报错，且重定向代码根本不会生效。

看你代码里的关键逻辑：

// 先发送JSON响应
res.status(StatusCodes.CREATED).json({ user: { name: user.name}, token });
// 再尝试重定向，此时响应已发送，必然报错
res.redirect(`api/v1/user/${user.name}/dashboard`)

解决方案 #

根据你的应用架构，分两种场景处理：

场景1：前后端分离应用（前端为SPA，如React/Vue） #

后端无需处理页面跳转，只返回用户信息和Token，由前端根据返回结果自行跳转页面。修改代码如下：

注册接口

const register = async (req, res) => {
  try{
    // 将User.create移入try块，避免创建失败直接抛出未捕获错误
    const user = await User.create({...req.body });
    const token = user.createJWT();
    // 仅返回必要数据，可附带跳转地址供前端使用
    res.status(StatusCodes.CREATED).json({ 
      user: { name: user.name}, 
      token,
      redirectUrl: `/api/v1/user/${user.name}/dashboard`
    });
  } catch (error) {
    res.status(500).json({
      success: false,
      error: error.message,
    });
  }
};

登录接口

const login = async (req, res) => {
  const { email, password } = req.body;
  if (!email || !password) {
    // 直接返回响应，避免抛出未捕获错误
    return res.status(StatusCodes.BAD_REQUEST).json("Please provide an email and password");
  }

  try {
    const user = await User.findOne({ email }).select("+password");

    if (!user) {
      return res.status(StatusCodes.UNAUTHORIZED).json("Invalid credentials");
    }
    const isMatch = await user.matchPassword(password);
    if (!isMatch) {
      return res.status(StatusCodes.UNAUTHORIZED).json("Invalid credentials");
    }
    const token = user.createJWT();
    res.status(StatusCodes.OK).json({ 
      user: {name: user.name}, 
      token,
      redirectUrl: `/api/v1/user/${user.name}/dashboard`
    });
  } catch (error) {
    res.status(500).json({
      success: false,
      error: error.message,
    });
  }
};

场景2：服务端渲染应用（使用EJS/Pug等模板引擎） #

无需返回JSON，直接将Token存入Cookie，然后执行重定向：

注册接口

const register = async (req, res) => {
  try{
    const user = await User.create({...req.body });
    const token = user.createJWT();
    // 将Token存入HttpOnly Cookie，提升安全性
    res.cookie('token', token, { 
      httpOnly: true, 
      secure: process.env.NODE_ENV === 'production',
      maxAge: 24 * 60 * 60 * 1000 // 1天有效期
    });
    // 直接重定向到仪表盘页面
    res.redirect(`/api/v1/user/${user.name}/dashboard`);
  } catch (error) {
    res.status(500).json({
      success: false,
      error: error.message,
    });
  }
};

登录接口

const login = async (req, res) => {
  const { email, password } = req.body;
  if (!email || !password) {
    return res.status(StatusCodes.BAD_REQUEST).json("Please provide an email and password");
  }

  try {
    const user = await User.findOne({ email }).select("+password");

    if (!user) {
      return res.status(StatusCodes.UNAUTHORIZED).json("Invalid credentials");
    }
    const isMatch = await user.matchPassword(password);
    if (!isMatch) {
      return res.status(StatusCodes.UNAUTHORIZED).json("Invalid credentials");
    }
    const token = user.createJWT();
    res.cookie('token', token, { 
      httpOnly: true, 
      secure: process.env.NODE_ENV === 'production',
      maxAge: 24 * 60 * 60 * 1000
    });
    res.redirect(`/api/v1/user/${user.name}/dashboard`);
  } catch (error) {
    res.status(500).json({
      success: false,
      error: error.message,
    });
  }
};

额外注意点 #

1. 原注册函数中User.create()放在try块外，若创建用户失败会直接抛出未捕获错误，务必移入try块内统一处理。
2. 避免使用throw new Error()后未通过错误中间件捕获，直接返回响应更稳妥。

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