Express处理POST请求重定向报ERR_HTTP_HEADERS_SENT错误如何解决

这个报错的核心原因是同一次请求中，服务端先后两次向客户端发送了响应，第一次响应已经把响应头发送给客户端后，后续代码又尝试修改/发送新的响应头，就会触发该错误。针对你的场景，常见诱因有两种：

• 你处理POST请求的路由中，res.redirect(303, '/register')执行之后，没有终止当前路由的代码逻辑，后续还执行了其他发送响应的操作（比如res.render、res.send、res.json、另一个res.redirect等）。最常见的写法问题就是没有给res.redirect加return，导致判断分支里执行完重定向后，还会继续跑分支外的响应逻辑。
• 异步逻辑处理错误：比如POST路由里的数据库查询、接口调用等异步操作没有做正确的流程控制，还没等异步回调执行就先调用了res.redirect，后续异步回调返回后又尝试发送响应。
• 小概率诱因：你没有正确配置express-session和connect-flash中间件，或者/register路由中res.render执行之后还有其他发送响应的代码。

1. 前置依赖配置 #

Express 原生不支持req.flash，需要先安装并正确配置依赖中间件，注意配置顺序不能颠倒：

npm install express-session connect-flash

入口文件配置：

const express = require('express')
const session = require('express-session')
const flash = require('connect-flash')
const app = express()

// 先配置session中间件
app.use(session({
  secret: "自定义的session加密密钥",
  resave: false,
  saveUninitialized: false
}))
// 再配置flash中间件
app.use(flash())

2. 修正POST注册路由逻辑 #

核心要保证res.redirect是当前请求的最后一个响应操作，要么加return终止后续代码执行，要么把后续逻辑放到else分支里：

app.post('/register', async (req, res) => {
  try {
    // 示例：先做参数校验、账号查重等业务逻辑
    const isUserExist = await UserModel.findOne({email: req.body.email})
    if (isUserExist) {
      const message = "该邮箱已被注册"
      req.flash('failed_registration', message)
      req.session.form_data = req.body // 存储表单数据用于回填
      // 加return终止后续代码执行，避免多次发送响应
      return res.redirect(303, '/register')
    }
    // 注册成功逻辑
    await UserModel.create(req.body)
    return res.redirect('/login')
  } catch (err) {
    req.flash('failed_registration', `注册失败：${err.message}`)
    req.session.form_data = req.body
    return res.redirect(303, '/register')
  }
})

3. 优化GET注册路由逻辑 #

你原有写法可以正常运行，补充清理旧表单数据的逻辑即可：

// Registration
app.get('/register', (req, res) => {
  const formData = req.session.form_data || {}
  // 取完表单数据后从session中删除，避免下次打开页面残留旧数据
  delete req.session.form_data
  res.render('register', {
    flash: req.flash('failed_registration'), 
    recaptcha: process.env.RECAPTCHA_WEB, 
    form_data: formData
  });
})

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