为何Express中间件的第4个参数仅在特定场景下失效？

问题背景 #

作为Node/Express新手，遇到一个奇怪的现象：给部分中间件添加第4个val参数时，中间件能正常工作，但给另一些中间件加了之后就失效了。了解到Express中带第四个参数的中间件会被视为错误处理中间件，但不确定是否与此相关，猜测这与中间件分别传入router.param和router.post有关，希望了解具体原理。

代码示例 #

controller.js #

exports.middleware1  = (req, res, next, val) => {
  if (Number(req.params.id) > tours.length) {
    return res.status(404).json({
      status: 'failed',
      message: 'Invalid ID',
    });
  }
  next();
};

exports.middleware2 = (req, res, next) => {
  if (!req.body.name || !req.body.price) {
    return res.status(400).json({
      status: 'fail',
      message: 'Missing name or price',
    });
  }

  next();
};

routes.js #

router.param('id', middleware1) // 即使包含“val”参数仍能正常工作
router.post(middleware2, createPost) // 添加第4个“val”参数后无法工作

原理解释 #

1. router.param()的特殊规则 #

Express的router.param()是专门用于处理URL路径参数（如示例中的id）的方法，它对传入的回调函数有强制参数要求：必须是(req, res, next, val)四个参数的格式，其中第四个参数val就是当前匹配到的URL参数的具体值。
所以你给middleware1添加第四个参数，完全符合该方法的调用规范，因此它能正常执行，完成id合法性校验的逻辑。

2. 普通路由中间件的参数规则 #

对于router.post()、router.get()这类普通路由方法，传入的中间件默认遵循三个参数的格式：(req, res, next)。
如果给这类中间件添加第四个参数，Express会自动将其识别为错误处理中间件——错误处理中间件的标准格式是(err, req, res, next)，只有在前面的中间件或路由处理函数通过next(err)主动抛出错误时，才会触发执行。
因此当你给middleware2添加第四个参数后，它就变成了错误处理中间件，在普通请求（无错误抛出）的流程中不会被执行，看起来就像是“失效”了。

总结 #

两者表现差异的核心原因在于：

• router.param()要求回调必须是4个参数，用来接收URL参数值；
• 普通路由的4参数中间件会被认定为错误处理中间件，仅在错误抛出时触发。

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