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

一篇文章学会如何使用 NestJS 过滤器处理系统全局异常情况

news 2025/9/11 1:04:19

前言

在实际的应用开发中，你或许遇到过异常处理机制不统一或错误信息展示混乱的现象。为了解决这些问题，NestJS提供了一个优雅的解决方案：过滤器（Filter）。本文将从实际出发，向你介绍NestJS过滤器的基本概念，重要用途和深度实例。

什么是NestJS的过滤器

当一个程序运行过程中发生了异常，并且这个异常没有被捕获处理，用户就会看到一些奇怪的错误信息，这种现象对用户体验非常不好。此时，NestJS的过滤器就登场啦！过滤器可以用来捕捉未被处理的异常，然后以一种更有秩序、更友好的方式显示，极大提升了用户体验。

NestJS过滤器的使用场景

接下来，我们将通过一些代码片段来解析过滤器在不同场景下的应用。

全局错误处理

创建一个全局过滤器来捕获所有未被处理的异常，以一致的风格返回给用户。

@Catch()
export class GlobalFilter implements ExceptionFilter {catch(exception: unknown, host: ArgumentsHost) {// 统一处理异常，返回友好的错误信息}
}
// 在main.ts中全局使用
app.useGlobalFilters(new GlobalFilter());

定制HTTP响应

可以用过滤器自定义服务器的响应格式。

@Catch()
export class TransformFilter implements ExceptionFilter {catch(exception: unknown, host: ArgumentsHost) {// 按照自定义的方式来配置返回的HTTP响应}
}
// 在特定的路由或控制器使用
@UseFilters(new TransformFilter())
@Controller('example')
export class ExampleController {
}

异常记录

在捕获异常的同时，使用过滤器记录错误信息。

@Catch()
export class LoggingFilter implements ExceptionFilter {catch(exception: unknown, host: ArgumentsHost) {// 记录异常堆栈信息console.error(exception);}
}
// 在全局或特定路由使用
app.useGlobalFilters(new LoggingFilter());

使用案例

下面是两个具体的过滤器使用案例，我们会在代码旁边添加详细注释，帮助你理解代码的每个部分。

案例一：全局异常过滤器

@Catch()
export class AllExceptionsFilter implements ExceptionFilter {catch(exception: unknown, host: ArgumentsHost) {const ctx = host.switchToHttp();const response = ctx.getResponse<Response>();const request = ctx.getRequest<Request>();const status = exception instanceof HttpException ? exception.getStatus() : 500;// 以统一的JSON格式返回错误信息response.status(status).json({statusCode: status,timestamp: new Date().toISOString(),path: request.url,});}
}
// 在主文件中全局注册这个过滤器
app.useGlobalFilters(new AllExceptionsFilter());

案例二：记录异常过滤器

@Catch(HttpException)
export class HttpExceptionFilter implements ExceptionFilter {catch(exception: HttpException, host: ArgumentsHost) {// 将异常信息输出到控制台console.error(`Exception occurred: ${exception.message}`);}
}
// 在指定的控制器或方法上通过使用装饰器使用这个过滤器
@UseFilters(HttpExceptionFilter)
export class ExampleController {
}