Node.js 编程实战：路由与中间件

在 Node.js Web 开发中，路由与中间件是构建应用的两大核心机制。路由负责将请求分发到具体的业务处理逻辑，而中间件则负责在请求处理过程中执行通用操作。二者相互配合，构成了 Express 等框架的运行基础。

理解路由匹配规则和中间件执行顺序，是写好 Node.js 服务端代码的关键。

一、什么是路由

路由用于描述请求路径与处理函数之间的映射关系。一个完整的路由通常由请求方法、路径和回调函数组成。

js 复制代码

app.get('/users', (req, res) => {
  res.send('user list');
});

当客户端以 GET 方法访问 /users 时，Express 会执行对应的处理函数。

二、路由匹配规则

Express 的路由是按定义顺序进行匹配的。一旦匹配成功，后续路由将不会再被执行。

js 复制代码

app.get('/users/:id', (req, res) => {
  res.send(req.params.id);
});

动态路由可以通过参数的形式获取路径中的变量，这在资源型接口设计中非常常见。

三、路由拆分与模块化

在项目规模扩大后，将所有路由写在一个文件中会导致代码难以维护。

js 复制代码

const express = require('express');
const router = express.Router();

router.get('/', (req, res) => {
  res.send('user list');
});

module.exports = router;

通过路由模块化，可以让项目结构更加清晰，职责更加明确。

四、中间件的基本概念

中间件本质上是一个函数，用于在请求进入路由之前或响应返回之前执行逻辑。

js 复制代码

app.use((req, res, next) => {
  console.log(req.method, req.url);
  next();
});

中间件可以访问请求对象、响应对象，并决定是否继续传递请求。

五、中间件的执行顺序

中间件按照注册顺序执行。

全局中间件优先执行
路由级中间件按顺序执行
错误处理中间件最后执行

一旦中间件没有调用 next，请求链将被中断。

六、常见中间件使用场景

中间件通常用于处理通用逻辑，例如：

请求日志记录
参数校验
用户认证与权限控制
请求体解析
跨域处理

将这些逻辑从业务代码中抽离，可以显著提升代码可读性。

七、路由级中间件

除了全局中间件，还可以为特定路由添加中间件。

js 复制代码

const auth = (req, res, next) => {
  if (!req.headers.token) {
    return res.status(401).send('unauthorized');
  }
  next();
};

app.get('/profile', auth, (req, res) => {
  res.send('profile');
});

这种方式可以实现精细化的权限控制。

八、错误处理中间件

Express 提供了专门的错误处理中间件形式。

js 复制代码

app.use((err, req, res, next) => {
  res.status(500).send('server error');
});

集中处理异常，有助于统一错误返回结构。

九、next 的使用注意事项

next 用于将控制权交给下一个中间件或路由。

需要注意：

不调用 next，请求将被阻塞
调用 next(err) 会直接进入错误处理中间件
避免重复调用 next

合理使用 next 是中间件设计的核心。

十、路由与中间件的协作模式

在实际项目中，常见的协作方式是：

中间件负责通用逻辑
路由负责业务分发
控制器负责业务实现

这种分层设计有助于项目长期维护和扩展。

十一、总结

路由和中间件是 Node.js Web 框架中最重要的基础设施。路由决定请求走向，中间件决定请求如何被处理。只有真正理解它们的执行机制和设计思路，才能写出结构清晰、易维护的服务端代码。

在项目初期建立合理的路由和中间件体系，将为后续功能扩展打下坚实基础。