说简单一点,中间件就是在你的请求和业务逻辑之间做一层拦截。
在 Node.js 中,中间件(Middleware) 是一种函数,它在 请求(Request)到达路由处理器之前,或在 响应(Response)发出之前,对请求进行处理。
🧠 一句话理解:
中间件就是“请求-响应”过程中的 拦截器、处理器或过滤器,可以对请求做日志、验证、解析、权限、响应包装等操作。
✅ 主要特征
在常见的 Node.js Web 框架(如 Express、Koa)中,中间件具有以下特点:
-
本质是一个函数
-
接收
(req, res, next)
这三个参数(Express) -
可以决定是否继续交给下一个中间件(调用
next()
)
📦 Express 中间件示例
示例:记录请求日志的中间件
const express = require('express');
const app = express();// 中间件函数
function logger(req, res, next) {console.log(`[${new Date().toISOString()}] ${req.method} ${req.url}`);next(); // 继续交给下一个中间件
}app.use(logger); // 应用中间件app.get('/', (req, res) => {res.send('Hello, Middleware!');
});app.listen(3000, () => console.log('Server started'));
🚀 中间件的分类
类型 | 说明 |
---|---|
应用级中间件 | 使用 app.use() 或 app.METHOD() 注册 |
路由级中间件 | 只在特定路由生效 |
错误处理中间件 | 带有 4 个参数 (err, req, res, next) |
内置中间件 | 如 express.json() 、express.static() |
第三方中间件 | 如 body-parser 、cors 、helmet 等 |
🧩 示例:多个中间件串联
app.use((req, res, next) => {console.log('中间件 A');next();
});app.use((req, res, next) => {console.log('中间件 B');next();
});app.get('/', (req, res) => {console.log('路由处理器');res.send('OK');
});
访问 /
页面,输出:
中间件 A
中间件 B
路由处理器
🔄 Koa 中的中间件机制(异步、洋葱模型)
Koa 中间件是 async 函数,支持“前进+回退”的洋葱模型执行机制:
const Koa = require('koa');
const app = new Koa();app.use(async (ctx, next) => {console.log('1. Start');await next(); // 进入下一层console.log('1. End');
});app.use(async (ctx, next) => {console.log('2. Start');await next();console.log('2. End');
});app.use(async ctx => {console.log('3. Handler');ctx.body = 'Hello from Koa';
});app.listen(3000);
输出顺序是:
1. Start
2. Start
3. Handler
2. End
1. End
📌 中间件的用途举例
目的 | 示例 |
---|---|
请求日志记录 | morgan , 自定义 logger 中间件 |
权限认证 | 判断用户 token 是否有效 |
解析请求体 | body-parser , express.json() |
设置响应头 | 跨域 CORS 控制 |
捕获异常 | 错误处理中间件 |
静态资源托管 | express.static('public') |
🧠 总结一句话:
中间件是构成 Node.js Web 框架(如 Express/Koa)核心机制之一,它将请求处理拆分为多个函数链式执行,使得逻辑清晰、易于复用和维护。
如果你想自己写一个中间件系统(类 Express),我可以提供底层实现原理代码。是否需要?