Nestjs框架: Guard(守卫)机制及其实战应用

nodejs企业级开发框架nest学习总结 - 3.NestJS入门guard、interceptor、customDecorator、循环引用、注入作用域、生命钩子等 NestJS入门guard、interceptor、customDecorator、循环引用、注入作用域、生命钩子等 官方API地址(点击跳转) 点击跳转到个人的博客(前面两节) 1.guard-守卫(每个中间件之后执行,但在任何拦截器或管道之前执行。) 1.1简单例子,守卫需要实现CanActivate接口 // guard/auth.guard.ts @Injectable() // 守卫必须... 阅读详情

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 ) 生命周期与全局执行顺序

  1. 整体请求周期顺序
    NestJS 请求处理流程遵循固定顺序:
    Middleware → Guards → Pipes → Interceptors → Controller → Exception Filters
    参考示意图:

    请求 → 中间件 → 守卫 → 管道 → 拦截器 → 控制器 → 响应 → 异常过滤器
    
  2. 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

NestJS jwt实现token验证,并使用自定义Guard来使无需专门每个接口配置Guard鉴权 nestJs实现jwt鉴权,全局定义guard使无需每个接口设置鉴权注解 阅读详情

相关推荐

RocketMQ源码分析之消息轨迹

文章目录前言一、消息轨迹二、消息轨迹源码分析1、producer端2、consumer端三、消息轨迹中存储的信息1.TraceContext2.TraceBean3.TraceType四、总结 前言   本篇文章将会从以下方面介绍消息轨迹:什么是消息轨迹?如何启用消息轨迹?示例demo、消息轨迹的源码分析和消息轨迹中存储的信息。最后会用一张图来总结消息轨迹的工作原理。 一、消息轨迹 1.什么是消息轨迹? 消息轨迹是用来跟踪记录消息发送、消息消费的轨迹。 2.如何启用消息轨迹? broker端 需要在b

不爱学习的小妞博客 1076

FLUX.1 LoRa 微调

微调的好处:可以让你突破换脸这种输入图片的场景约束,微调好的模型可以让你真正的文生图。换脸只能根据输入的图片和视频来生成内容。

szmars的博客 3623

当兵心理测试软件,当兵心理测试题及答案

心理测试是一种比较先进的测试方法,它是指通过一系列手段,将人的某些心理特征数量化,来衡量个体心理因素水平和个体心理差异差异的一种科学测量方法。小编为你整理了当兵心理测试题及答案,希望对你有所参考帮助。征兵心理测试题(1代表是2代表否)1、我的胃口很好。12、我早上起来的时候,多半觉得睡眠充足,头脑清醒13、我喜欢看报纸上的犯罪新闻。14、有时我常感到困难重重,无法克服。25、我时常遇见一些所谓的专...

weixin_42128393的博客 1万+

底层软件测试规范,QA评审底层测试

本文首发于【林子的空间】“林子,咱们上次讨论的高效Desk check清单,用起来还挺好的,最近我们组每次Desk check变得顺利多了,Dev也是越来越熟练。”玥玥跟我说。“真好!我们组感觉也是这样!”“不过,我听小慧说他们组有人对QA review UT提出了一些concern(质疑),觉得QA review的价值不大,基本都是Dev给讲一遍,QA也提不出来什么反馈...”玥玥补充说道。“哦...

weixin_42144707的博客 1189

告别高延迟!用RV1106+4G模块+libdatachannel搭建低功耗WebRTC监控,保姆级避坑指南

本文详细介绍了如何利用RV1106低功耗处理器、4G模块和libdatachannel库构建嵌入式WebRTC监控系统,解决高延迟问题。通过硬件选型、系统优化和核心代码实现,提供了一套完整的低功耗实时视频传输方案,特别适合智能安防和工业物联网应用。

weixin_42527401的博客 194

verilog扰码器设计及仿真

本设计使用verilog语言实现扰码器设计与仿真 本工程在quartusII下实现并在modelsim下进行仿真 设计中包括加扰器和解扰器模块、仿真测试模块等. 下面是工程截图: 下面是modelsim仿真截图: 仿真代码部分可以自己设计更改,输出也会不同。 ...

QQ_778132974的博客 1727

对角两对双差速轮AGV的平移、直行、转弯和原地旋转之PID控制

本示例将展示如何使用PID控制算法,控制具有对角线布置的两对双差速轮(左前和右后)的AGV,实现平移、直行、转弯和原地旋转等运动。通过对车辆的运动学和PID控制器的设计,我们可以精确地控制AGV的运动

xiaoc100200的博客 1513

Windows部署小龙虾 OpenClaw 报错不断?参考这篇文章,轻松配置 OpenClaw 所需环境

想在Windows上部署OpenClaw却频频报错?🔧 本文详细梳理了OpenClaw部署必需环境的安装步骤和官方下载地址 📦,提供完整的验证清单和常见问题排查方法,帮你一次性搞定所有环境配置,顺利部署OpenClaw ✅

XiaoqiangClub的博客 365

华为的C语言编程规范.pdf

华为技术有限公司内部技术规范。本规范制定了编写C语言程序的基本原则、规则和建议。从代码的清晰、简洁、可测试、安全、程序效率、可移植各个方面对C语言编程作出了具体指导。

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

蓝牙模块HM-10手册

蓝牙模块HM-10手册,该手册对蓝牙模块HM-10进行了详细的介绍和使用方法以及一些AT指令。

Camera2Demo

在Camera2 的基础上进行封装,使得Camera2一堆初始化逻辑与Activity分离,降低耦合度,完成预览拍照并保存的操作

上一篇: Nestjs框架: 使用 JWT 实现 NestJS 鉴权模块的开发与集成
下一篇: Nestjs框架: 基于 Argon2 的用户登录注册安全机制设计与实现
Wang's Blog
博客等级 码龄12年 7440粉丝 2427原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Wang's Blog

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值