Guard 的基本概念与作用
在 NestJS 中,Guard(守卫) 是一种用于控制路由访问权限的机制,它与中间件类似,但具有访问 ExecutionContext 的能力,可以获取当前请求的执行上下文,从而实现更精细化的权限控制
它的核心职责是根据运行时条件(如角色、访问控制列表等)判断是否允许访问某个路由处理程序,这一过程通常称为授权(Authorization)
在实际开发中,我们常将 Guard 与 JWT 身份验证结合使用,以实现对用户权限的精细化控制。例如,Guard 可以判断一个用户是否具有某个角色,从而决定是否允许其访问特定接口
我们关注这些关键词: @Injectable()、canActivate()、ExecutionContext、DI Container
Guard 与 Middleware 的区别
虽然 Guard 和 Middleware 都可以用于拦截请求,但两者有本质区别:
- Middleware:只能访问请求对象(request)和响应对象(response),无法获取执行上下文(ExecutionContext),因此无法确切知道下一步要执行哪个路由处理程序。
- Guard:可以访问 ExecutionContext,从而确切知道当前请求将进入哪个控制器或方法,具备更高级的控制能力。
重点: Guard 是基于 ExecutionContext 的,它可以访问路由处理程序的元数据信息,这是其区别于 Middleware 的关键所在
Guard 的生命周期与执行顺序
1 ) 生命周期与全局执行顺序
-
整体请求周期顺序
NestJS 请求处理流程遵循固定顺序:
Middleware → Guards → Pipes → Interceptors → Controller → Exception Filters
参考示意图:请求 → 中间件 → 守卫 → 管道 → 拦截器 → 控制器 → 响应 → 异常过滤器 -
Guard 的定位
- Guards 在中间件之后执行,但在管道和拦截器之前执行
- 若 Guard 返回
false或抛出异常,后续流程(管道、拦截器、控制器)不会执行
2 ) 多 Guard 执行顺序规则
场景 1:局部 Guard(装饰器顺序)
@UseGuards(GuardA, GuardB) // 执行顺序:GuardA → GuardB
@Get('test')
getData() {
... }
- 规则:按
@UseGuards()参数顺序从左到右依次执行[7]。 - 中断机制:若
GuardA返回false,则GuardB不会执行。
场景 2:全局 Guard + 局部 Guard
// 全局注册(main.ts)
app.useGlobalGuards(new GlobalGuard());
// 控制器局部使用
@UseGuards(LocalGuard)
@Controller('users')
export class UserController {
... }
- 执行顺序:
GlobalGuard→LocalGuard - 全局 Guard 优先级:始终先于控制器或路由级的局部 Guard
Guard 的定义与实现
一个自定义 Guard 需要实现 CanActivate 接口,通常继承自 NestJS 提供的抽象类 AuthGuard 或 AuthGuard<JwtStrategy>
1 )创建自定义 Guard
使用 CLI 创建 Guard:
nest generate guard common/guards/admin --flat
集中管理 metadata 变量
constants/metadata.constant.ts
1076



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



