镇江专业网站制作公司山东省住房城乡建设厅查询网站首页

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}`);
});