当一个请求被发送到 NestJS 应用时，守卫会在管道和拦截器之前运行。守卫会查看请求的上下文，并决定是否允许请求继续执行。如果守卫返回 true 或一个 true 解析的 Promise，请求就会继续执行；如果返回 false 或一个 false 解析的 Promise，请求则会被拒绝，并且可以抛出异常（例如 UnauthorizedException）来提供拒绝的原因。

通过这样的机制，NestJS 的守卫提供了一个强大而灵活的方法来控制请求的访问权限，它们可以根据应用的需要灵活地被应用在不同的级别上，从全局到特定的单一路由。

拦截器

拦截器（Interceptors）提供了一种强大的方法来拦截和扩展函数行为。拦截器可以调用在方法执行之前和之后，它们适用于添加额外的逻辑到函数的入口和出口，如日志记录、异常处理、响应映射、调用链中的数据转换等。NestJS 允许在不同的层级设置拦截器：全局拦截器、控制器层拦截器和路由拦截器。

全局拦截器对应用中的所有控制器和路由有效。这种类型的拦截器常用于需要全局应用的逻辑，例如全局错误处理、日志记录或应用范围内的响应结构标准化。

全局守卫通常在应用的主模块中设置，通过 APP_GUARD 提供器来提供：

路由和控制器这些就不讲了，查文档都能查得到。

通过调试，我们是可以接收到数据的控制器返回的数据的，如下图所示：

20240421171017

根据这个特性，我们可以实现以下功能：

响应转换：在数据发送给客户端之前对其进行转换或包装，这适用于创建一致的响应格式。例如，你可能想要将所有的响应数据封装在一个标准的响应体结构中，包括成功标志、消息和数据本身。

执行时间监控：通过在拦截器中记录处理请求的起始和结束时间，可以用来监控处理请求的时间，这对于性能分析和优化非常有用。

缓存：拦截器可以用于实现缓存策略，从而减少对下游系统或数据库的请求。通过在拦截器中缓存数据，并在后续请求中返回缓存的数据，可以显著提高应用性能。

管道

管道（Pipes）是用来处理输入数据的工具，主要用于数据转换和数据验证。管道的作用是在数据最终被控制器处理器处理之前，对这些数据进行一些必要的操作。这些操作包括但不限于类型转换、数据格式化、数据校验等

管道的主要职责：

数据转换：将输入数据转换成所需的形式。例如，将字符串类型的日期转换为 JavaScript 的 Date 对象，或者将字符串 "true" 或 "false" 转换为布尔值。

数据验证：检查输入数据的有效性，并在数据不合法时抛出异常。这通常涉及一套验证规则，如果数据不符合这些规则，则阻止数据进一步处理。

接下来我们编写一个管道，来对某个接口中的参数进行类型转换，转换完成之后并对该数字进行加一操作：

这个时候我们要在控制器上或者录音上面添加 UsePipes 装饰器：

这里接收到了我们传入的 query 参数，它的字段是 id，值是字符串的 1：

20240421172726

Nest 自带九个开箱即用的管道

在 NestJS 中，管道是用于处理请求数据的验证和转换的重要组件。NestJS 提供了一些内置的管道，这些管道开箱即用，可以直接在应用中使用来处理常见的数据验证和转换任务。截至最新版本，NestJS 提供了以下几种内置管道：

1. ValidationPipe

这是最常用的管道之一，用于基于类和装饰器进行复杂的验证。它通常与 class-validator 和 class-transformer 库一起使用，可以自动验证 DTO（数据传输对象）并抛出异常。

2. ParseIntPipe

将字符串转换成整数。如果转换失败，则自动抛出异常。

3. ParseFloatPipe

将字符串转换成浮点数。如果转换失败，也会自动抛出异常。

4. ParseBoolPipe

解析传入的字符串或其他值为布尔值，如果值为 'true' 或 '1'，则返回 true，否则返回 false。如果提供的值无法转换为布尔值，它将抛出异常。

5. ParseArrayPipe

解析并验证传入的数组。这个管道可以确保您接收的参数确实是数组类型，并支持进一步的数组项验证。

6. ParseUUIDPipe

解析并验证传入的字符串是否为有效的 UUID。如果不是，会自动抛出异常。

7. DefaultValuePipe

设置参数的默认值，如果请求中未包含该参数，或参数值为 undefined，则使用指定的默认值。

8. ParseEnumPipe

解析并验证传入的字符串是否属于特定枚举的有效值。

9. ParseDatePipe

解析并验证传入的字符串是否可以转换为有效的日期对象。

这些内置管道极大简化了数据处理逻辑，使得开发者可以更加专注于业务逻辑的实现，同时保持代码的清晰和安全性。使用这些管道可以有效地避免常见的数据处理错误，如类型错误和格式错误，并确保应用程序的数据输入更加健壮和可靠。

过滤器（filter）

异常过滤器（Exception Filters）是用于处理整个应用程序中抛出的异常的组件。异常过滤器提供了一种捕获和处理应用程序抛出的异常的方法，允许开发者控制异常的响应格式以及执行一些清理或日志记录操作。

异常过滤器的核心用途是改变抛出异常时的处理行为。在 NestJS 中，异常过滤器可以：

转换异常响应：将技术性的错误信息转换为更友好或更标准化的响应格式。

日志记录：在异常发生时进行日志记录，帮助开发者进行错误追踪和监控。

错误堆栈清理：清理错误堆栈信息，以防止敏感信息泄露给客户端。

条件响应：基于不同类型的异常返回不同的响应，例如根据不同的错误类型设置不同的 HTTP 状态码。

异常过滤器可以通过实现 ExceptionFilter 接口创建。下面是一个简单的异常过滤器示例，它捕获所有异常并自定义响应格式：

在全局模块中全局注册：

NestJS 的内置请求异常过滤器

在 NestJS 中，处理 HTTP 异常时通常会使用一系列预定义的异常类，这些类继承自 HttpException 并为常见的 HTTP 状态代码提供快捷方式。下面是您提到的每种异常的详细说明，以及它们通常何时使用：

1. BadRequestException (400)

表示客户端请求错误，服务器无法理解。

2. UnauthorizedException (401)

表示请求需要用户认证信息，如果没有提供或者提供的认证信息不正确，则会抛出此异常。

3. NotFoundException (404)

表示请求的资源未找到，即无法根据客户端的请求找到相应的资源。

4. ForbiddenException (403)

表示服务器理解请求但拒绝执行。这通常是由于客户端没有足够的权限。

5. NotAcceptableException (406)

表示服务器无法提供符合 Accept-Header 指定的条件的响应。

6. RequestTimeoutException (408)

表示服务器希望断开空闲连接之前，客户端没有在服务器预备等待的时间内产生请求。

7. ConflictException (409)

表示请求冲突，如请求信息与服务器当前状态冲突。

8. GoneException (410)

表示资源在服务器上不再可用，并且没有任何已知的转发地址。

9. PayloadTooLargeException (413)

表示请求实体过大。

10. UnsupportedMediaTypeException (415)

表示请求格式正确，但是服务器不支持请求的媒体类型。

11. UnprocessableException (422)

表示虽然请求内容类型正确，且生成的请求实体也符合数据结构要求，但其中含有语义错误。

12. InternalServerErrorException (500)

表示服务器遇到了一个错误，无法完成请求。

13. NotImplementedException (501)

表示服务器不支持当前请求所需要的功能。

14. BadGatewayException (502)

表示作为网关或代理工作的服务器尝试执行请求时，从上游服务器接收到无效的响应。

15. ServiceUnavailableException (503)

表示服务器目前无法使用（由于超载或停机维护）。

16. GatewayTimeoutException (504)

表示作为网关或代理的服务器未能及时从上游服务器或外部辅助服务器接收请求。

使用场景

这些异常可以在您的控制器或服务中直接抛出。NestJS 会捕获这些异常并自动转换为相应的 HTTP 响应，返回给客户端。这种机制使得异常处理在整个应用中既统一又简便。

总结

NestJS 是构建在 Express.js 之上的一个框架，但它也提供了与其他底层 HTTP 框架（如 Fastify）的兼容性。这种设计让 NestJS 不只是单纯的封装，而是提供了一种更加灵活和强大的应用架构方式。

IOC：自己实现了模块机制，可以导入导出 provider，实现自动依赖注入，简化了对象的创建

AOP：抽象了 Guard、Interceptor、Pipe、Exception Filter 这 4 种切面，可以通过切面抽离一些通用逻辑，然后动态添加到某个流程中

任意切换底层平台：nest 基于 ts 的 interface 实现了不和任何底层平台耦合，http 可以切换 express 和 fastify，websocket 可以切换 socket.io 和 ws。而且 4 种切面也实现了可以跨 http、websocket、微服务来复用。

这种灵活性和强大的抽象层使得 NestJS 不仅仅是对 Express 的封装，而是一个功能全面的、可适用于多种场景的现代 Node.js 框架。通过这种方式，NestJS 使得开发者能够构建出结构清晰、易于维护且高效的应用。