Express 中的路由处理函数与中间件链式调用详解_技术教程

本文深入解析 express.js 路由中多参数回调、中间件函数链及 `next` 参数机制，阐明 `app.get(path, ...handlers)` 的执行逻辑、参数传递规则与中间件协作原理。

在 Express.js 中，路由定义远不止 app.get(path, handler) 这一简单形式。其核心能力之一，正是支持多个中间件函数按序串联执行，构成灵活可控的请求处理流水线。

✅ 多中间件函数的声明方式

Express 官方 API 明确支持如下语法（见文档）：

app.get('/user/:id/edit', a, b, c, (req, res) => {
  res.send('Profile edited');
});

其中 a、b、c 均为符合中间件签名的函数（即 (req, res, next) => {}）。它们将严格按声明顺序从左到右依次调用，形成一条中间件链（middleware stack）。

✅ 中间件函数的三种典型签名

Express 并不强制要求所有中间件都接收 next 参数，而是根据函数形参个数动态决定其行为：

函数签名	行为说明
(req, res) => { ... }	终结型处理函数：Express 认为其已“接管响应”，不再调用后续中间件；若未调用 res.send() 等响应方法，请求将挂起（超时）
(req, res, next) => { ... }	标准中间件：必须显式调用 next()（无参）以移交控制权给下一个中间件；也可传错误 next(err) 触发错误处理流程
(err, req, res, next) => { ... }	错误处理中间件：仅在有错误传递（next(err)）时被匹配，且必须有 4 个形参

⚠️ 注意：next 不是由 JavaScript 编译器注入的，而是 Express 内部调度器（如 layer.handle_request()）在调用每个中间件时主动传入的。若函数未声明 next 形参，该参数会被静默忽略（类似 function foo(a) { } 调用 foo(1, 2, 3) 时，后两个参数自动丢弃）。

✅ 实际工作流示例

// 中间件 a：校验用户权限
const auth = (req, res, next) => {
  if (!req.session.userId) {
    return res.status(401).send('Unauthorized');
  }
  console.log('✅ Auth passed');
  next(); // 继续下一环节
};

// 中间件 b：加载用户数据
const loadUser = (req, res, next) => {
  req.user = { id: req.params.id, name: 'Alice' };
  console.log('✅ User loaded');
  next();
};

// 终结处理器
app.get('/user/:id/edit', auth, loadUser, (req, res) => {
  res.json({ message: `Editing ${req.user.name}'s profile` });
});

执行顺序为：auth → loadUser → final handler，任一环节未调用 next() 或提前 res.send()，则链路终止。