Express路由处理器内调用函数与使用中间件的差异探究

先看你给出的两种写法示例：

中间件写法 #

function logOriginalUrl (req, res, next) {
  console.log('Request URL:', req.originalUrl)
  next()
}

function logMethod (req, res, next) {
  console.log('Request Type:', req.method)
  next()
}

const logStuff = [logOriginalUrl, logMethod]
app.get('/user/:id', logStuff, (req, res, next) => {
  res.send('User Info')
})

路由内直接调用函数写法 #

// 注：原写法会报错，因req未传入，修正后如下
function logOriginalUrl(req) {
  console.log('Request URL:', req.originalUrl);
}

function logMethod(req) {
  console.log('Request Type:', req.method);
}

app.get('/user/:id', (req, res, next) => {
  logOriginalUrl(req);
  logMethod(req);
  res.send('User Info')
})

这两种写法看似功能相似，但存在核心差异，你忽略的要点主要有这些：

1. 参数传递与上下文绑定 #

中间件会被Express自动注入req、res、next三个核心对象，无需手动传递，天然和当前请求上下文绑定；而路由内调用的函数必须显式传递req/res，否则会因变量未定义报错，写法更繁琐。

2. 异步处理与错误流转 #

如果涉及异步操作（比如数据库查询、第三方API调用）：

• 中间件可以通过next(err)将错误统一传递给Express的全局错误处理中间件，无需在每个中间件内重复处理错误逻辑；
• 路由内调用异步函数时，必须手动用try/catch捕获错误，再调用next(err)，否则未捕获的异步错误会导致请求挂起或服务器崩溃，容错成本更高。

示例对比：

异步中间件写法

async function fetchUserMiddleware(req, res, next) {
  try {
    req.user = await User.findById(req.params.id);
    next();
  } catch (err) {
    next(err); // 错误交给全局错误处理器
  }
}

路由内调用异步函数

app.get('/user/:id', async (req, res, next) => {
  try {
    const user = await fetchUser(req.params.id);
    res.send(user);
  } catch (err) {
    next(err); // 必须手动捕获并传递，否则出错后请求无响应
  }
})

3. 复用性与模块化程度 #

中间件支持全局挂载（app.use(fetchUserMiddleware)）或批量挂载到多个路由，一次定义即可在任意路由复用；而路由内直接调用的函数，每个需要的路由都得手动写调用代码，代码冗余，难以统一维护。比如要给10个路由加日志逻辑，中间件只需挂载一次，而直接调用要写10遍logOriginalUrl(req)。

4. 请求流程控制能力 #

中间件通过next()可以灵活控制请求流转：

• 可以跳过后续中间件/路由处理器（比如权限校验不通过时，直接返回res.status(403).send('无权访问')，不调用next()）；
• 可以调用next('route')跳过当前路由的后续处理器，跳转到下一个匹配的路由。

而路由内调用的函数无法直接干预请求流程，只能通过返回值或修改res对象让路由处理器判断，逻辑耦合度更高。

5. 错误处理中间件的原生支持 #

Express的错误处理中间件（必须包含err、req、res、next四个参数）只能捕获通过next(err)传递的错误。路由内直接抛出的错误如果没被try/catch捕获，会触发Node.js的unhandledRejection或uncaughtException，导致服务不稳定；而中间件内的错误通过next(err)可以被全局错误处理器统一捕获、格式化返回，更符合Express的设计规范。

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