Nest：深入理解中间件 middleware

关于 Next 中间件

Nest 中间件中间件是处于请求和响应周期中间的函数，类似 express 中间件，可以访问请求对象（req）、响应对象（res）、和应用程序的下一个中间件函数。
中间件的主要任务是可以执行以下操作：

执行任何代码。
修改请求和响应对象。
结束请求-响应周期。
调用堆栈中的下一个中间件函数。

如果当前中间件没有结束请求-响应周期，它必须调用 next() 方法将控制权传递给下一个中间件，否则请求将被挂起。

Nest 中间件应用场景：

请求日志记录：记录每个进入应用的请求的详细信息，如请求路径、方法、来源IP等，便于调试和监控。
身份验证和授权：在请求继续处理之前验证用户的身份，检查用户是否有权限访问特定的路由或资源。
请求数据处理：对请求中的数据进行预处理，如解析、格式化、校验等。
设置响应头：为即将发送的响应设置一些通用的HTTP头，如跨域资源共享（CORS）头、安全相关的头等。
性能监控：监控请求处理的时间，以便分析和优化性能。
缓存：实现缓存逻辑，减少对后端服务或数据库的请求，提高应用性能。
限流：控制请求的频率，防止服务被过度使用或遭受拒绝服务攻击（DDoS）。
错误处理：捕获请求处理过程中的异常，进行统一的错误处理。
国际化：根据请求头或其他指示来设置语言环境，实现内容的国际化。
API版本管理：根据请求的版本信息（如URL路径、请求头）来路由到不同版本的处理逻辑。

创建中间件

Nest 中间件可以是一个函数，也可以是一个带有 @Injectable() 装饰器，实现 NestMiddleware 接口的类：
创建 Nest 项目：

nest new middleware-test -p npm

创建 middleware：

nest g middleware logger --no-spec --flat

手动标注类型，并在 next 前后插入一些代码：

或者是一个函数：
Nest：深入理解中间件 middleware
它们之间的区别也就在，类可以实现依赖注入。而函数不行。

使用中间件

在 AppModule 模块中，使用 configure 方法来设置中间件。你可以为整个应用、特定路由或一组路由应用中间件。
Nest：深入理解中间件 middleware
forRoutes 方法用于指定中间件应用到的路由。它可以接收多种不同类型的参数，以满足不同的路由匹配需求。

字符串路径：
可以直接传递一个字符串，表示中间件将应用于该特定路径。

.forRoutes('users');

路径模式（带通配符）：
可以使用通配符 * 来匹配一组路由。

.forRoutes('users/*');

控制器类：
可以传递一个控制器类，中间件将应用于该控制器中定义的所有路由。

.forRoutes(UsersController);

路由对象：
可以传递一个对象，其中包含 path 和 method 属性，用于更精确地定义中间件应用的路由和方法。

.forRoutes({ path: 'users', method: RequestMethod.GET });

路由对象数组：
还可以传递一个路由对象数组，以将中间件应用于多个不同的路由和方法。

.forRoutes(
  { path: 'users', method: RequestMethod.GET },
  { path: 'users', method: RequestMethod.POST },
  { path: 'admin', method: RequestMethod.ALL }
);

控制器和方法数组：
你可以传递一个数组，其中包含控制器类和方法，以将中间件应用于特定控制器的特定方法。

.forRoutes({ path: 'users', method: RequestMethod.ALL }, UsersController);

使用 forRoutes 方法时，可以根据需要混合使用这些配置，以实现对中间件应用的精确控制。

创建并绑定多个中间件

绑定多个中间件，可以在 configure 方法中使用链式调用 .apply() 方法，并传入多个中间件。
我们先创建个中间件：

也可以这样写：

中间件会按照从左到右，从上到下顺序对所有路由生效，我们访问页面，看下打印结果：
Nest：深入理解中间件 middleware

创建全局中间件

全局中间件在整个应用程序中的每个路由上都会生效。
除了上面使用的 forRoutes('*')，还可以在 main.ts 文件中使用 app.use() 方法：

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { logger } from './logger.middleware';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.use(logger); // 将 logger 函数注册为全局中间件
  await app.listen(3000);
}
bootstrap();

这种形式不能注入依赖，也不能指定路由，不建议使用。

middleware 和 interceptor 区别

Nest 的 middleware 和 interceptor 都可以在请求前后加入一些逻辑，有什么区别呢？

interceptor 是能从 context 里拿到目标 class 和 handler，进而通过 reflector 拿到它的 metadata 等信息的，middleware 就不可以。
interceptor 可以用 rxjs 操作符来组织响应处理流程，middleware 也不可以。

interceptor 更适合处理与具体业务相关的逻辑，而 middleware 适合更通用的处理逻辑。

原文链接：https://juejin.cn/post/7340532030810882048 作者：云牧牧