概述
- 在 NestJS 框架中,中间件(Middleware)、管道(Pipes)、过滤器(Filters)、拦截器(Interceptors) 均属于请求处理流程的核心组件,它们共同构成了 NestJS 的 请求生命周期(Request Lifecycle)
- 中间件、管道、过滤器、拦截器属于 请求生命周期,用于管理单次请求的处理流程;而 onModuleInit 等钩子属于应用生命周期,用于管理应用状态
- 两者的区别
类型 请求生命周期组件 应用程序生命周期钩子 作用对象 单次 HTTP 请求 整个应用启动/关闭过程 典型方法 middleware.use(),@UseInterceptors()onModuleInit(),onApplicationShutdown()关注点 请求处理流程控制 资源初始化、数据库连接释放等 - 中间件、管道、过滤器、拦截器属于 请求生命周期,用于管理单次请求的处理流程;而
onModuleInit等钩子属于 应用生命周期,用于管理应用状态
请求生命周期
1 )请求生命周期中的角色与执行顺序
当客户端发起请求时,NestJS 会按以下顺序处理
-
中间件(Middleware)
- 定位:请求的第一道关卡,处理全局或路由级别的预处理(如日志、CORS)。
- 特点:可访问请求/响应对象,需调用
next()传递控制权。 - 示例:日志记录、请求头校验
-
守卫(Guards)
- 定位:第二道关卡,负责权限验证(如角色校验、JWT 认证)
- 特点:决定请求是否进入控制器(Controller)
- 注:用户问题未提及守卫,但因其在流程中紧接中间件,需补充说明
-
拦截器(Interceptors)
- 定位:第三道关卡,包裹控制器逻辑,处理请求前后逻辑。
- 功能:
- 请求前:修改请求数据;
- 响应后:统一封装响应格式、记录执行时间
- 示例:全局响应包装(
{ code: 200, data: ... })
-
管道(Pipes)
- 定位:第四道关卡,聚焦数据转换与验证。
- 功能:
- 转换:将输入数据转为目标类型(如字符串转数字);
- 验证:校验参数有效性,失败时抛出异常
- 示例:
@Param('id', ParseIntPipe)自动转换路径参数
-
控制器(Controller)
- 定位:执行业务逻辑,返回响应。
-
拦截器 (Post)
- 响应前的程序拦截
-
异常过滤器(Exception Filters)
- 定位:请求流程的“安全网”,捕获全局或局部异常
- 功能:统一处理错误响应(如转换技术异常为友好提示)
2 ) 代码示例:实现请求周期钩子
基于您提供的NestJS生命周期结构图,我已全面补充了每个组件的完整代码实现,确保所有子类(全局/控制器/路由级别)均有完整示例。以下是按执行顺序重新生成的代码:
src/
├── middleware/
│ └── global.middleware.ts
├── guards/
│ ├── global.guard.ts
│ ├── controller.guard.ts
│ └── route.guard.ts
├──interceptors/
│ ├── global.interceptor.ts
│ ├── controller.interceptor.ts
│ └── route.interceptor.ts
├──pipes/
│ ├── global.pipe.ts
│ ├── controller.pipe.ts
│ └── route.pipe.ts
├── controllers/
│ └── example.controller.ts
├── filters/
│ ├── global.filter.ts
│ └── route.filter.ts
2.1 中间件(Middleware)
// 全局中间件
@Injectable()
export class GlobalMiddleware implements NestMiddleware {
use(req: Request, res: Response, next: NextFunction) {
console.log('全局中间件执行');
next();
}
}
// 模块中间件(在模块内注册)
@Module({
})
export class AppModule implements NestModule {
configure(consumer: MiddlewareConsumer) {
consumer.apply(ModuleMiddleware).forRoutes('*');
}
}
2.2 守卫(Guards)
// 全局守卫
@Injectable()
export class GlobalGuard implements CanActivate {
canActivate(context: ExecutionContext): boolean {
console.log('全局守卫验证');
return true;
}
}
// 控制器守卫
@Controller('users')
@UseGuards(ControllerGuard)
export class UserController {
}
// 路由守卫
@Get('profile')
@UseGuards(
1969



被折叠的 条评论
为什么被折叠?



