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

---

一、什么是路由

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

js

体验AI代码助手

代码解读

复制代码

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

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

---

二、路由匹配规则

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

js

体验AI代码助手

代码解读

复制代码

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

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

---

三、路由拆分与模块化

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

js

体验AI代码助手

代码解读

复制代码

const express = require('express'); const router = express.Router(); router.get('/', (req, res) => { res.send('user list'); }); module.exports = router;

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

---

四、中间件的基本概念

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

js

体验AI代码助手

代码解读

复制代码

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

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

---

五、中间件的执行顺序

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

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

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

---

六、常见中间件使用场景

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

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

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

---

七、路由级中间件

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

js

体验AI代码助手

代码解读

复制代码

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

体验AI代码助手

代码解读

复制代码

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

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

---

九、next 的使用注意事项

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

需要注意：

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

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

---

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

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

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

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

---

十一、总结

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

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

原文：https://juejin.cn/post/7585888537642418191