NestJS 中请求生命周期的顺序是什么？

Question

Accepted Answer

**请求生命周期**是请求在 NestJS 中经过的精确一系列组件的顺序——middleware、guards、interceptors、pipes、处理器、然后再次 interceptors，以及错误时的 exception filters。了解准确的顺序对于理解*何时*每个逻辑片段运行至关重要。

## 完整的顺序

```text
Incoming Request
   │
   ▼
1. MIDDLEWARE            (Express-style; raw req/res; runs first)
   │
   ▼
2. GUARDS                (authorization — return true to continue, false/throw to block)
   │
   ▼
3. INTERCEPTORS (pre)    (logic BEFORE the handler — start timing, etc.)
   │
   ▼
4. PIPES                 (validate/transform the handler's arguments — DTO validation)
   │
   ▼
5. ROUTE HANDLER         (your controller method runs)
   │
   ▼
6. INTERCEPTORS (post)   (logic AFTER the handler — transform the response)
   │
   ▼
Response

✗ If an exception is thrown ANYWHERE above →
7. EXCEPTION FILTERS     (catch it and format the error response)
```

## 为什么顺序很重要（实际后果）

```text
• Guards run BEFORE pipes → authorization is checked before input validation
  (no point validating a body for an unauthorized request)
• Pipes run JUST BEFORE the handler → the handler always gets validated/transformed args
• Interceptors straddle the handler → they can measure its duration and transform output
• Filters catch errors from any stage → centralized, consistent error handling
```

## 在每个类别中，作用域顺序适用

```text
For each type (guards, interceptors, pipes), they run in this scope order:
  Global → Controller → Method (route)
So a global guard runs before a controller-level guard, before a route-level guard.
```

## 一个具体的例子

```ts
@Controller("users")
@UseGuards(AuthGuard)                    // 2. checks authorization
@UseInterceptors(LoggingInterceptor)     // 3 (pre) + 6 (post)
export class UsersController {
  @Post()
  create(@Body() dto: CreateUserDto) {    // 4. ValidationPipe validates dto, 5. handler runs
    return this.usersService.create(dto);
  }
}
// Flow: middleware → AuthGuard → LoggingInterceptor(before) → ValidationPipe →
//       create() → LoggingInterceptor(after) → response (or → filter on error)
```

## 为什么这很重要

理解请求生命周期顺序是正确构建 NestJS 应用程序的基础——它决定了*何时*每个横切关注点的逻辑执行，这直接影响设计决策和调试。

顺序有真实的、实际的意义：**guards 在 pipes 之前运行**，因此授权在麻烦验证输入之前被正确检查（未授权的请求在验证之前被拒绝）；**pipes 在处理器之前运行**，保证处理器始终接收到验证过的、转换过的参数；**interceptors 包装处理器**（在*之前和之后*运行），这正是让它们能够计时执行和转换响应的方式；以及 **exception filters 从任何阶段捕获错误**，启用集中式错误处理。

了解这个顺序——加上类别内的作用域顺序（全局 → 控制器 → 方法）——让你能够将逻辑放在正确的组件中、预测执行流程、调试为什么某些东西在预期时运行（或不运行），以及正确地架构功能。

它将框架的所有请求处理片段（middleware、guards、interceptors、pipes、filters）联系在一起，形成一个连贯的心智模型，使其成为一个重要的、经常被测试的话题，反映了对 NestJS 如何处理请求的真实理解。