当前位置: 首页 > news >正文

NestJS 系列教程(四):中间件、中断器与异常过滤器详解

🔄 NestJS 系列教程(四):中间件、中断器与异常过滤器详解

✨ 本篇目标

你将学会:

  • 什么是中间件(Middleware),如何拦截请求
  • 什么是异常过滤器(Exception Filters),如何统一处理错误
  • Nest 中的请求生命周期是怎样的
  • 编写全局/模块级中间件与异常处理器

🚦 1. 中间件(Middleware)

什么是中间件?

中间件是一个在请求到达处理函数之前被调用的函数。你可以用它来记录日志、验证请求、添加请求数据等。

中间件的特征:

  • 类似 Express 的中间件函数 (req, res, next)
  • 可以访问请求与响应对象
  • 必须手动调用 next() 才会进入下一个处理阶段

🛠️ 编写中间件

示例:日志中间件 logger.middleware.ts

src/common/middleware/logger.middleware.ts 文件中创建:

import { Injectable, NestMiddleware } from '@nestjs/common';
import { Request, Response, NextFunction } from 'express';@Injectable()
export class LoggerMiddleware implements NestMiddleware {use(req: Request, res: Response, next: NextFunction) {console.log(`[Request] ${req.method} ${req.originalUrl}`);next();}
}

🔧 应用中间件(模块级注册)

cats.module.ts 中添加:

import { Module, NestModule, MiddlewareConsumer } from '@nestjs/common';
import { CatsController } from './cats.controller';
import { CatsService } from './cats.service';
import { LoggerMiddleware } from '../common/middleware/logger.middleware';@Module({controllers: [CatsController],providers: [CatsService],
})
export class CatsModule implements NestModule {configure(consumer: MiddlewareConsumer) {consumer.apply(LoggerMiddleware).forRoutes('cats'); // 仅拦截 /cats 路由}
}

可以通过 .forRoutes() 控制中间件作用范围,如所有 GET 路由、指定控制器、指定路径等。


🧨 2. 异常过滤器(Exception Filters)

默认行为

Nest 默认抛出的异常会被自动转化为 JSON 格式:

{"statusCode": 400,"message": "some error","error": "Bad Request"
}

但你可以创建自定义异常处理逻辑。


编写自定义异常过滤器

创建 common/filters/http-exception.filter.ts

import {ExceptionFilter,Catch,ArgumentsHost,HttpException,
} from '@nestjs/common';
import { Request, Response } from 'express';@Catch(HttpException)
export class HttpExceptionFilter implements ExceptionFilter {catch(exception: HttpException, host: ArgumentsHost) {const ctx = host.switchToHttp();const response = ctx.getResponse<Response>();const request = ctx.getRequest<Request>();const status = exception.getStatus();const errorResponse = {success: false,timestamp: new Date().toISOString(),path: request.url,message: exception.message,};response.status(status).json(errorResponse);}
}

✍️ 应用异常过滤器

方法级

@Post()
@UseFilters(HttpExceptionFilter)
create(@Body() dto: CreateCatDto) {throw new BadRequestException('手动抛出异常示例');
}

控制器级

@UseFilters(HttpExceptionFilter)
@Controller('cats')
export class CatsController {}

全局注册(推荐)

main.ts 中添加:

import { HttpExceptionFilter } from './common/filters/http-exception.filter';async function bootstrap() {const app = await NestFactory.create(AppModule);app.useGlobalFilters(new HttpExceptionFilter());await app.listen(3000);
}

🔁 3. Nest 请求生命周期简图

一个请求在 Nest 应用中经历以下流程:

客户端请求↓
中间件 (Middleware)↓
守卫 (Guards)↓
拦截器 (Interceptors)↓
管道 (Pipes)↓
控制器方法 (Controller)↓
服务 (Service)↑
异常过滤器 (ExceptionFilter)(如有异常)↑
响应客户端

本章主要关注中间件与异常过滤器,后续我们将逐步引入守卫、拦截器、管道的深入使用。


✅ 本篇小结

本章我们学习了:

  • 如何编写并应用 Nest 的中间件(Logger)
  • 理解并实现异常过滤器(统一错误响应格式)
  • 掌握 Nest 请求生命周期的关键阶段

🔮 下一篇预告

第5篇:守卫(Guards)与认证逻辑实现(基于角色与 JWT)

下一篇将介绍如何使用 Guards 实现路由级权限控制、角色限制、以及 JWT 用户验证机制。

http://www.lryc.cn/news/582888.html

相关文章:

  • 17-C#的socket通信TCP-1
  • 【python】 time_str = time_str.strip() 与 time_str = str(time_str).strip() 的区别
  • Spring Batch终极指南:原理、实战与性能优化
  • 开源 python 应用 开发(四)python文件和系统综合应用
  • ${project.basedir}延申出来的Maven内置的一些常用属性
  • Linux 第一个系统程序 - 进度条
  • 基于springboot的物流配货系统
  • 内网服务器怎么设置公网远程访问? windows桌面连接和Linux自带SSH外网异地跨网用完整步骤教程
  • JK触发器Multisim电路仿真——硬件工程师笔记
  • 【读论文】GLM-4.1V-Thinking 解读:用强化学习解锁 VLM 的通用推理能力
  • 进程于线程 -1
  • 小架构step系列08:logback.xml的配置
  • 数据提取之lxml模块与xpath工具
  • LLM探索的时代
  • 大学数字经济专业课程介绍
  • maven 发布到中央仓库之持续集成-03
  • 无缝矩阵支持音频分离带画面分割功能的全面解析
  • 【适合 Java 工程师的 AI 转型方向】
  • Shader面试题100道之(21-40)
  • 复杂任务攻坚:多模态大模型推理技术从 CoT 数据到 RL 优化的突破之路
  • 使用python的 FastApi框架开发图书管理系统-前后端分离项目分享
  • Linux操作系统:再谈虚拟地址空间
  • 【UE5】虚幻引擎的运行逻辑
  • 智能推荐社交分享小程序(websocket即时通讯、协同过滤算法、时间衰减因子模型、热度得分算法)
  • Tomcat与IIS:核心差异及接口调用实战解析
  • Spring中过滤器和拦截器的区别及具体实现
  • 26.安卓逆向2-frida hook技术-解密响应
  • LoRaWAN 有几种入网方式?
  • DMA技术与音频数据的存储和播放
  • LLM视觉领域存在模型视觉识别不准确、细粒度视觉任务能力不足等科学问题