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() 全局注册，也可以绑定到特定路由。

全局使用：所有请求都会经过该中间件
局部使用：只对指定路径或路由生效

示例：

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() 的时机，避免请求卡住。