Express.js自定义错误处理器中正确结束响应的方式是什么

核心结论 #

Express 框架中，res.render()、res.send()、res.json()、res.sendFile() 这类内置的响应输出方法，都会自动调用底层的 res.end() 结束响应流程，不需要手动额外调用 res.end()，也不需要调用 next() 交由默认处理器处理。

你提到的官方示例是完全符合规范的：res.status(500) 仅用于设置响应状态码，不会结束响应；后续调用 res.render() 会完成模板渲染、写入响应体、自动结束响应，整个请求流程已经闭环，不会出现挂起、无法被垃圾回收的问题。

常见混淆点澄清 #

• 单独调用 res.status() 不会结束响应：该方法只是设置响应状态码的链式调用工具，本身不会做任何响应写入和结束操作。如果代码中仅调用了 res.status(xxx)，没有后续调用任何输出类方法，也没有调用 next() 传递请求，才会导致请求挂起。
• 不要把 Restify 的逻辑套用到 Express 上：Restify 和 Express 设计逻辑有本质区别，Restify 的 res.send() 确实不会自动结束响应流，但 Express 的响应输出方法底层已经封装了 res.end() 调用，只要调用了上述输出类方法，响应就会正常结束，资源也会正常释放。
• 仅两种场景需要在错误处理器中调用 next()：
  1. 当前错误处理器不负责处理该错误，需要交由下一个错误处理器继续处理
  2. 处理完自定义逻辑后，需要触发 Express 内置的默认错误处理逻辑（该场景非常少见，一般仅在需要 Express 输出默认错误页时使用）

正确写法示例 #

末尾最终错误处理器（不需要向下传递错误） #

function errorHandler (err, req, res, next) {
  // 可先执行错误日志上报等前置逻辑
  if (req.xhr) {
    // 接口请求返回JSON格式响应
    res.status(500).json({ code: 500, msg: '服务器内部错误', error: err.message })
  } else {
    // 页面请求渲染错误模板
    res.status(500).render('error', { error: err })
  }
  // 无需额外调用 res.end() 或 next()
}

中间层错误处理器（仅做逻辑处理，不输出响应） #

function logErrors (err, req, res, next) {
  console.error('请求出错堆栈：', err.stack)
  // 把错误传递给下一个错误处理器
  next(err)
}

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