Express中间件详解：核心作用、分类与实战代码示例
在Node.js的Express框架中，中间件是一个核心概念。简单来说，中间件是一个函数，它拦截HTTP请求，在请求到达路由处理之前或响应发送给客户端之前执行一些逻辑操作。Express应用的整个请求处理过程本质上是一条中间件链——每个请求都会依次经过这些中间件函数，最后到达路由处理器（如果有的话）。1. 中间件的标准形式与核心作用
中间件函数接收三个参数：req（请求对象）、res（响应对象）、next（下一个中间件函数）。典型写法如下：
function middleware(req, res, next) {
// 处理逻辑：如请求解析、身份校验、日志记录等
next(); // 将控制权传递给下一个中间件或路由
}
核心作用主要有两点：
- 在请求到达具体路由之前执行操作（如解析请求体、校验Token、添加请求头）。
- 在响应发送之前执行操作（如记录日志、压缩响应、添加CORS头）。
通过next()函数，中间件可以决定是否继续往下传递。如果不调用next()，请求会挂起；如果调用next(err)，则直接跳转到错误处理中间件。
2. 中间件的五大分类
2.1 应用程序级中间件
通过app.use()挂载到Express应用实例上，作用于全局或匹配特定路径。常用于统一处理：JSON解析、日志、安全验证等。
const express = require('express');
const app = express();
// 内置中间件：解析JSON请求体
app.use(express.json());
// 自定义全局日志中间件
app.use((req, res, next) => {
console.log(`[${Date.now()}] ${req.method} ${req.url}`);
next();
});
2.2 路由级中间件
挂载在express.Router()实例上，仅作用于当前路由模块，适合模块化组织业务逻辑。
const router = express.Router();
// 路由级中间件：仅对/users模块生效
router.use((req, res, next) => {
console.log('进入用户模块');
next();
});
// 将路由挂载到应用上，路径前缀为/users
app.use('/users', router);
2.3 错误处理中间件
专门捕获并处理错误，必须接收四个参数：err、req、res、next。当任何中间件或路由调用next(err)时，Express会跳过所有普通中间件，直接执行这个错误处理中间件。
app.use((err, req, res, next) => {
res.send({
status: 1,
msg: err instanceof Error ? err.message : err,
});
});
注意：错误处理中间件必须放在所有路由之后定义，否则无法捕获到错误。
2.4 内置中间件
Express原生提供，无需额外安装，直接通过express.xxx()使用。常见的有：
- express.static('public')：托管静态资源文件。
- express.json()：解析Content-Type为application/json的请求体。
- express.urlencoded({ extended: true })：解析URL-encoded格式的请求体（通常是表单提交数据）。
2.5 第三方中间件
由社区开发，通过npm安装，扩展Express功能。
- cors：解决跨域问题。
- multer：处理文件上传。
- express-validator：数据验证。
- morgan：HTTP请求日志记录。
这些中间件一般遵循相同的(req, res, next)签名，使用前安装并导入即可：
const cors = require('cors');
app.use(cors());
3. 实战要点与理解
- 中间件顺序至关重要：Express按代码顺序执行中间件。全局中间件（如JSON解析、日志）应放在最前面，路由中间件在中间，错误处理中间件放在最后。
- 每个中间件必须调用next()或发送响应（如res.json()），否则请求会挂死。
- 内置中间件express.json()和express.urlencoded()分别处理JSON和表单数据，若同时需要两者，都需注册。
掌握这些分类与用法，就能灵活地利用中间件机制进行模块化、可复用的Express应用开发。
Re: Express中间件详解：核心作用、分类与实战代码示例
楼主的分享非常详细清晰，从中间件的基础概念到五大分类都讲得很透彻，特别是错误处理中间件要放在路由后面这个细节，新手很容易忽略。代码示例也很实用，配合文字说明一目了然。想问一下，实际项目中如果同时用`app.use(express.json())`和`app.use(express.urlencoded(...))`，顺序有没有讲究？还是先注册哪个都行？Re: Express中间件详解：核心作用、分类与实战代码示例
楼主的讲解非常清晰，把Express中间件的概念、作用和分类都梳理得很透彻。特别是用代码示例来展示每种中间件的用法，让人一目了然。实际开发中，中间件的顺序确实最容易被忽略，楼主特意强调了这一点，很实用。感谢分享！Re: Express中间件详解：核心作用、分类与实战代码示例
楼主总结得非常全面清晰！特别是中间件顺序和错误处理中间件必须放在最后这一点，新手很容易踩坑。我自己刚开始用Express时就因为把`app.use(express.json())`写在路由后面导致一直拿不到请求体😂 另外想补充一个小技巧：如果需要在中间件里提前结束请求（比如权限校验失败），可以直接用`res.status(401).send(...)`然后不调`next()`，这样请求就不会继续往下走了。 感谢分享，收藏学习了！
页:
[1]