Node.js ERR_HTTP_HEADERS_SENT错误：用户注册重复响应问题排查

我正在为应用实现认证功能，但企业用户注册时抛出Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client错误。明明用了wrapAsync错误处理函数，还是出现这个问题。我希望每个请求只返回一次响应，但实际并非如此，也找不到二次响应的来源，求分析原因。

错误栈 #

Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client
    at new NodeError (node:internal/errors:387:5)
    at ServerResponse.setHeader (node:_http_outgoing:603:11)
    at ServerResponse.header (/Users/alisha/Desktop/Oshi/node_modules/express/lib/response.js:794:10)
    at ServerResponse.send (/Users/alisha/Desktop/Oshi/node_modules/express/lib/response.js:174:12)
    at done (/Users/alisha/Desktop/Oshi/node_modules/express/lib/response.js:1035:10)
    at /Users/alisha/Desktop/Oshi/node_modules/ejs-mate/lib/index.js:356:7
    at tryHandleCache (/Users/alisha/Desktop/Oshi/node_modules/ejs/lib/ejs.js:280:5)
    at Object.exports.renderFile (/Users/alisha/Desktop/Oshi/node_modules/ejs/lib/ejs.js:491:10)
    at View.renderFile [as engine] (/Users/alisha/Desktop/Oshi/node_modules/ejs-mate/lib/index.js:298:7)
    at View.render (/Users/alisha/Desktop/Oshi/node_modules/express/lib/view.js:135:8)

相关代码 #

1. /register路由 #

router.post('/register', wrapAsync(async(req,res)=>{
    const {username, email, nearestLocation, phoneNum, password, RePassword}= req.body;
    if(password !== RePassword) {
        req.flash('error', 'Please retype same password for confirmation')
        return res.redirect('/firm/register')
    }
    
        const hashpw= await bcrypt.hash(password, 12);
        const registerBusiness= new Businesses({
            username: username, email: email, location: nearestLocation, phoneNum: phoneNum,   password: hashpw})
        await registerBusiness.save();
        req.session.currentAccount= registerBusiness.id;
        req.session.currentAccountName = registerBusiness.username;
        req.flash('success', 'Successfully registered your Business account')
        return res.redirect('/home')
}))

2. wrapAsync模块 #

module.exports = (fn)=>{
    return ((req,res,next)=>{
        fn(req,res,next).catch(next)
    })
}

问题分析与解决 #

这个错误的核心是同一个HTTP请求中被触发了多次响应发送操作，你的wrapAsync写法没问题，它能正确捕获异步函数的异常并传递给Express的错误处理流程，问题出在请求处理的其他环节，按以下优先级排查：

1. 检查路由是否被重复挂载
   这是最常见的原因：如果你的代码中多次执行了app.use('/firm', router)（比如在app.js里写了两次，或者路由文件被重复引入），同一个POST请求会被两个完全相同的路由处理函数处理。第一个函数执行res.redirect发送了响应，第二个函数再执行时，就会试图再次设置响应头，直接触发这个错误。搜索项目代码，确认路由只被挂载一次。

2. 检查全局错误处理中间件的逻辑
   如果registerBusiness.save()这类异步操作抛出异常（比如字段验证失败、数据库连接错误），wrapAsync会把错误传给next(err)，触发全局错误处理中间件。如果这个中间件没有判断响应头是否已发送就直接发送响应，就可能和之前的响应冲突。给错误处理中间件加个判断：

   app.use((err, req, res, next) => {
       // 如果响应头已经发送，交给Express默认处理
       if (res.headersSent) {
           return next(err);
       }
       req.flash('error', err.message);
       res.redirect('/error');
   });
   

3. 排查路由之后的中间件
   检查是否有在路由处理之后执行的中间件（比如日志、清理类中间件），这些中间件如果试图修改响应头或发送响应，会和路由已经发送的响应冲突。可以暂时注释掉非必要的中间件，逐一排查。

4. 验证session/flash中间件的配置
   某些session中间件在写入session数据时，如果配置不当（比如重复设置Cookie），可能会在路由发送响应后再次修改响应头。可以检查session中间件的配置，确认没有重复调用或错误配置。

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