跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

Express中间件怎么自定义_Express中间件原理与自定义开发教程

中间件是Express中处理请求的核心,通过函数访问req、res和next,可实现日志、权限校验等功能。1. 基本结构为接收req、res、next参数的函数,需调用next()继续流程;2. 使用app.use()全局注册或在路由中局部使用;3. 常见场景包括请求日志记录(如打印方法和路径)、身份验证(检查token合法性)、数据预处理(挂载用户信息到req);4. 错误处理中间件有四个参数(err, req, res, next),通过next(err)触发,用于统一捕获异常并返回错误响应。掌握执行顺序与next调用时机是关键。 在Express中,中间件是处理请求和响应的核心机制。它本质上是一个函数,可以访问请求对象( req )、响应对象( res )以及应用请求-响应循环中的下一个中间件函数( next )。通过自定义中间件,你可以统一处理日志、权限校验、数据解析等任务。 中间件的基本结构 一个典型的中间件函数包含三个参数: req 、 res 和 next 。其基本格式如下:
function customMiddleware(req, res, next) { // 在这里处理逻辑 console.log('请求时间:', new Date().toISOString()); // 调用 next() 让流程继续 next(); }
这个函数可以放在任何 路由 之前使用,Express会按顺序执行中间件。 如何使用自定义中间件 定义好中间件后,可以通过 app.use() 全局注册,也可以绑定到特定路由。 全局使用:所有请求都会经过该中间件 局部使用:只对指定路径或路由生效 示例: 灵活路由的PHP库 灵活路由的PHP库 下载
const express = require('express'); const app = express(); app.use(customMiddleware); // 全局注册 app.get('/', (req, res) => { res.send('Hello World'); }); app.get('/user', customMiddleware, (req, res) => { res.send('用户页面'); });
常见自定义中间件场景 实际开发中,可以根据需求编写不同功能的中间件。 1. 请求日志记录
function logger(req, res, next) { console.log(`${req.method} ${req.path}`); next(); }
2. 身份验证中间件
function auth(req, res, next) { const token = req.headers['authorization']; if (!token) return res.status(401).send('未授权'); // 简单验证示例 if (token === 'secret-token') { next(); } else { res.status(403).send('令牌无效'); } }
3. 数据预处理 比如统一给请求对象添加属性:
function addUserInfo(req, res, next) { req.user = { id: 123, name: 'Alice' }; next(); }
错误处理中间件 Express支持专门的错误处理中间件,它有四个参数,区别于普通中间件。
function errorHandler(err, req, res, next) { console.error(err.stack); res.status(500).send('服务器出错'); } // 使用时通过 next(err) 触发 app.get('/error', (req, res, next) => { next(new Error('测试错误')); }); app.use(errorHandler);
基本上就这些。掌握中间件原理后,你可以灵活构建可复用、模块化的请求处理流程。关键是理解执行顺序和调用 next() 的时机,避免请求卡住。

相关文章