当前位置：首页 > news >正文

express的中间件，全局中间件，路由中间件，静态资源中间件以及使用注意事项，获取请求体数据

news 来源：原创 2025/4/25 6:18:14

Express 中间件系统 的详细讲解，包括全局中间件、路由中间件、静态资源中间件、请求体解析中间件，以及使用注意事项👇

🌐 一、什么是中间件（Middleware）？

中间件是函数，在请求到达路由处理器之前被调用，用于拦截、修改请求或响应，或者终止请求处理流程。

中间件函数格式：

(req, res, next) => { /* your logic */ }

调用 next() 表示继续传递请求给下一个中间件；否则请求会被“卡住”。

📌 二、全局中间件（应用级）

示例 1：日志中间件（所有请求都会执行）

app.use((req, res, next) => {console.log(`[${new Date().toISOString()}] ${req.method} ${req.url}`);next(); // 继续执行下一个中间件
});

🚏 三、路由中间件（局部）

只对特定路由生效的中间件：

const checkAuth = (req, res, next) => {if (req.query.token === '123') {next();} else {res.status(401).send('Unauthorized');}
};app.get('/secure', checkAuth, (req, res) => {res.send('Access granted!');
});

📁 四、静态资源中间件

内置中间件 express.static() 用于托管静态文件（HTML、CSS、JS、图片等）：

app.use(express.static('public')); // 访问 public 文件夹// 假设 public 中有 index.html，可以直接通过 http://localhost:3000/index.html 访问

🧾 五、获取请求体数据的中间件

1. 解析 JSON 格式

app.use(express.json());

2. 解析表单格式（x-www-form-urlencoded）

app.use(express.urlencoded({ extended: true }));

示例 POST 路由：

app.post('/login', (req, res) => {const { username, password } = req.body;res.send(`用户名：${username}, 密码：${password}`);
});

⚠️ 六、使用注意事项

注意事项	说明
中间件顺序	中间件是按顺序执行的，先定义的先执行
`next()` 必须调用	否则请求会卡住，不继续执行后续中间件或路由
错误处理中间件	中间件中捕获错误时要调用 `next(err)`，Express 会自动进入错误处理中间件
静态中间件要放前面	否则可能被其他中间件或路由拦截
不要滥用全局中间件	建议用局部中间件提高性能与可维护性

🎁 七、完整示例

const express = require('express');
const app = express();
const port = 3000;// 中间件
app.use(express.json());
app.use(express.urlencoded({ extended: true }));
app.use(express.static('public'));// 全局日志中间件
app.use((req, res, next) => {console.log(`[LOG] ${req.method} ${req.url}`);next();
});// 路由中间件示例
const auth = (req, res, next) => {if (req.query.token === '123') next();else res.status(401).send('未授权');
};app.get('/public-info', (req, res) => res.send('Everyone can see this'));app.get('/private-info', auth, (req, res) => res.send('This is protected'));app.post('/form', (req, res) => {res.send(req.body);
});app.listen(port, () => {console.log(`App running at http://localhost:${port}`);
});