NestJSのリクエストライフサイクルの順序は何ですか?

Question

Accepted Answer

**リクエストライフサイクル**は、リクエストがNestJSで通過するコンポーネントの正確な順序です — middleware、guard、interceptor、pipe、handler、そして再びinterceptor、エラー時にはexception filterです。正確な順序を知ることは、*いつ*各ロジックが実行されるかを理解するために重要です。

## 完全な順序

```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アプリケーションを正しく構築するための基本です — 各クロスカッティングロジックが*いつ*実行されるかを正確に決定し、設計上の決定とデバッグに直結します。

この順序は実質的で実践的な意義を持ちます：**guardはpipeより前に実行される**ため、認可は入力の検証に手間をかける前に正しくチェックされます（未認可のリクエストは検証の前に拒否されます）；**pipeはhandlerのすぐ前に実行される**ため、handlerが常に検証済みで変換されたargumentを受け取ることが保証されます；**interceptorはhandlerをラップする**（前後に実行される）ため、これが実行時間を計測してレスポンスを変換することを可能にします；そして**exception filterはあらゆる段階からエラーをキャッチする**ため、一元的なエラー処理が可能になります。

この順序を知ること — さらにカテゴリ内のスコープの順序（グローバル → コントローラー → メソッド）— により、ロジックを正しいコンポーネントに配置し、実行フローを予測し、期待通りに実行される（または実行されない）理由をデバッグでき、フィーチャーを正しく設計できます。

フレームワークの全てのリクエスト処理の部品（middleware、guard、interceptor、pipe、filter）を首尾一貫したメンタルモデルにまとめます。これは重要で頻繁にテストされるトピックであり、NestJSがリクエストを処理する方法についての本当の理解を反映しています。