nestjs中的中间件顺序
在NestJS中,中间件(Middleware)、管道(Pipes)、拦截器(Interceptors)和守卫(Guards)是四种常用的处理请求的机制。它们的执行顺序是有明确规定的,这对于理解和设计NestJS应用的请求处理流程非常重要。
执行顺序概述
- 中间件(Middleware)
- 守卫(Guards)
- 拦截器(Interceptors)(Before handling the request)
- 管道(Pipes)
- 拦截器(Interceptors)(After handling the request)
详细执行顺序
-
中间件(Middleware):
- 中间件在路由处理之前执行,可以用于处理请求的预处理工作,比如日志记录、请求解析、认证等。
- 中间件只能在模块级别或应用级别定义,不能在控制器或方法级别定义。
- 中间件在请求生命周期的最早阶段执行。
-
守卫(Guards):
- 守卫用于实现基于角色的访问控制和认证逻辑。
- 守卫在每个请求之前执行,决定是否允许请求继续。
- 守卫可以在模块、控制器或方法级别定义。
-
拦截器(Interceptors)(Before handling the request):
- 拦截器在请求处理前后都可以执行。
- 在处理请求前,拦截器可以对请求进行预处理,比如修改请求对象或添加额外的逻辑。
- 拦截器可以在模块、控制器或方法级别定义。
-
管道(Pipes):
- 管道用于验证和转换请求数据。
- 管道在控制器方法处理请求之前执行,确保请求数据的有效性和格式。
- 管道可以在控制器参数、方法或控制器级别定义。
-
拦截器(Interceptors)(After handling the request):
- 拦截器在处理完请求之后,可以对响应进行后处理,比如修改响应对象或添加日志记录。
- 这部分拦截器在控制器方法执行完毕后执行。
示例代码
为了更好地理解执行顺序,下面是一个示例代码,展示了如何在NestJS中定义和使用中间件、守卫、拦截器和管道。
中间件
import { Injectable, NestMiddleware } from '@nestjs/common';
@Injectable()
export class LoggerMiddleware implements NestMiddleware {
use(req: any, res: any, next: () => void) {
console.log('Request...');
next();
}
}
守卫
import { Injectable, CanActivate, ExecutionContext } from '@nestjs/common';
import { Observable } from 'rxjs';
@Injectable()
export class AuthGuard implements CanActivate {
canActivate(
context: ExecutionContext,
): boolean | Promise<boolean> | Observable<boolean> {
console.log('Guard...');
return true; // or some authentication logic
}
}
拦截器
import {
Injectable,
NestInterceptor,
ExecutionContext,
CallHandler,
} from '@nestjs/common';
import { Observable } from 'rxjs';
import { tap } from 'rxjs/operators';
@Injectable()
export class LoggingInterceptor implements NestInterceptor {
intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
console.log('Before...');
return next
.handle()
.pipe(
tap(() => console.log('After...')),
);
}
}
管道
import {
Injectable,
PipeTransform,
ArgumentMetadata,
BadRequestException,
} from '@nestjs/common';
@Injectable()
export class ValidationPipe implements PipeTransform {
transform(value: any, metadata: ArgumentMetadata) {
console.log('Pipe...');
if (!value) {
throw new BadRequestException('Validation failed');
}
return value;
}
}
应用示例
import { Module, NestModule, MiddlewareConsumer } from '@nestjs/common';
import { APP_GUARD, APP_INTERCEPTOR, APP_PIPE } from '@nestjs/core';
@Module({
providers: [
{
provide: APP_GUARD,
useClass: AuthGuard,
},
{
provide: APP_INTERCEPTOR,
useClass: LoggingInterceptor,
},
{
provide: APP_PIPE,
useClass: ValidationPipe,
},
],
})
export class AppModule implements NestModule {
configure(consumer: MiddlewareConsumer) {
consumer
.apply(LoggerMiddleware)
.forRoutes('*');
}
}
在这个示例中:
- LoggerMiddleware 会首先执行,记录请求信息。
- AuthGuard 会接着执行,进行认证和授权检查。
- LoggingInterceptor 会在请求处理前执行
Before...
逻辑。 - ValidationPipe 会在控制器方法处理请求之前验证和转换请求数据。
- LoggingInterceptor 会在请求处理后执行
After...
逻辑。
通过这种方式,你可以充分利用NestJS的中间件、守卫、拦截器和管道来构建灵活和可维护的请求处理流程。
本文来自博客园,作者:jialiangzai,转载请注明原文链接:https://www.cnblogs.com/zsnhweb/articles/18353530
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列:如何用heaptrack跟踪.NET程序的非托管内存泄露
· 开发者必知的日志记录最佳实践
· TypeScript + Deepseek 打造卜卦网站:技术与玄学的结合
· Manus的开源复刻OpenManus初探
· AI 智能体引爆开源社区「GitHub 热点速览」
· C#/.NET/.NET Core技术前沿周刊 | 第 29 期(2025年3.1-3.9)
· 从HTTP原因短语缺失研究HTTP/2和HTTP/3的设计差异