如何修复Express Node.js中Cannot set headers after they are sent报错

这个报错的核心触发原因是同一次HTTP请求被重复发送了响应：

• 你封装的validations函数内部，参数校验不通过时的return仅会退出validations函数本身，不会终止外层路由回调的执行
• 当参数不符合规则时，validations函数已经向客户端返回了400状态的校验失败响应，HTTP响应头已经发送给客户端；但代码回到路由回调后会继续向下执行，再次尝试发送200状态的成功响应，此时就会触发「Cannot set headers after they are sent to the client」错误。
  另外原代码里的错误提示单词存在拼写错误：validations faild正确拼写应为validations failed。

你可以选择以下任意一种方案修复：

方案1：最小改动修复现有逻辑 #

调整validations函数的返回值，路由层根据校验结果判断是否终止后续逻辑：

1. 修改校验函数，返回布尔值标识校验是否通过

function validations(req, res) {
  const errors = validationResult(req);
  const errorMessage = {
    data: null,
    message: "validations failed",
    errors: errors.array(),
  };
  if (!errors.isEmpty()) {
    res.status(400).json(errorMessage)
    // 校验失败返回false
    return false
  }
  // 校验通过返回true
  return true
}

2. 路由回调中增加判断，校验失败直接终止执行

router.post(
  "/login",
  body("username").notEmpty(),
  body("password").isLength({ min: 8 }),
  (req, res) => {
    // 校验不通过直接return，不执行后续业务逻辑
    if (!validations(req, res)) return
    const {username, password } = req.body;
    const id = users.length;
    
    res.status(200).json({
      message:'ok',
      data:true
    })
  }
);

方案2：使用Express中间件规范写法（推荐） #

express-validator本身就是基于Express中间件机制设计的，你可以把校验结果判断抽成通用中间件，从根源上避免漏写return导致的重复响应问题，也方便其他接口复用校验逻辑：

1. 编写通用校验处理中间件

// 所有接口的校验错误都可以用这个中间件统一处理
function handleValidationError(req, res, next) {
  const errors = validationResult(req);
  if (!errors.isEmpty()) {
    return res.status(400).json({
      data: null,
      message: "validations failed",
      errors: errors.array()
    })
  }
  // 校验通过放行，进入后续业务逻辑
  next()
}

2. 调整路由写法，把校验处理中间件挂载到业务逻辑之前

router.post(
  "/login",
  body("username").notEmpty(),
  body("password").isLength({ min: 8 }),
  handleValidationError, // 校验不通过会直接返回错误，不会进入后面的回调
  (req, res) => {
    const {username, password } = req.body;
    const id = users.length;
    
    res.status(200).json({
      message:'ok',
      data:true
    })
  }
);

注意：所有Express接口开发中，只要执行了res.json()/res.send()/res.redirect()等发送响应的方法，必须确保后续逻辑不会再执行，否则就会出现重复发送响应的报错。

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