NestJS 요청 생명주기 순서는 어떻게 되나요?

Question

Accepted Answer

**요청 생명주기**는 NestJS에서 요청이 통과하는 구성 요소의 정확한 순서입니다 — middleware, guard, interceptor, pipe, 핸들러, 그 다음 다시 interceptor, 그리고 오류 시 exception filter. 정확한 순서를 아는 것은 각 로직 조각이 *언제* 실행되는지 이해하는 데 결정적입니다.

## 전체 순서

```text
들어오는 요청
   │
   ▼
1. MIDDLEWARE            (Express 스타일; 원시 req/res; 가장 먼저 실행)
   │
   ▼
2. GUARD                 (인가 — 계속하려면 true, 차단하려면 false/throw)
   │
   ▼
3. INTERCEPTOR (이전)    (핸들러 이전 로직 — 타이밍 시작 등)
   │
   ▼
4. PIPE                  (핸들러 인수 검증/변환 — DTO 검증)
   │
   ▼
5. 라우트 핸들러          (controller 메서드 실행)
   │
   ▼
6. INTERCEPTOR (이후)    (핸들러 이후 로직 — 응답 변환)
   │
   ▼
응답

✗ 위 어디서든 예외가 던져지면 →
7. EXCEPTION FILTER      (잡아서 오류 응답으로 포맷)
```

## 순서가 중요한 이유 (실무적 결과)

```text
• Guard가 pipe보다 먼저 실행 → 입력 검증 전에 인가 확인
  (인가되지 않은 요청에 대해 본문을 검증할 이유 없음)
• Pipe가 핸들러 바로 직전에 실행 → 핸들러는 항상 검증/변환된 인수를 받음
• Interceptor가 핸들러를 양쪽에서 감쌈 → 소요 시간 측정 및 출력 변환 가능
• Filter가 모든 단계의 오류를 잡음 → 중앙화되고 일관된 오류 처리
```

## 각 범주 내에서 scope 순서가 적용됩니다

```text
각 타입(guard, interceptor, pipe)마다 이 scope 순서로 실행:
  전역(Global) → controller → 메서드(라우트)
그래서 전역 guard가 controller 수준 guard보다, 그것이 라우트 수준 guard보다 먼저 실행됩니다.
```

## 구체적인 예

```ts
@Controller("users")
@UseGuards(AuthGuard)                    // 2. 인가 확인
@UseInterceptors(LoggingInterceptor)     // 3 (이전) + 6 (이후)
export class UsersController {
  @Post()
  create(@Body() dto: CreateUserDto) {    // 4. ValidationPipe가 dto 검증, 5. 핸들러 실행
    return this.usersService.create(dto);
  }
}
// 흐름: middleware → AuthGuard → LoggingInterceptor(이전) → ValidationPipe →
//       create() → LoggingInterceptor(이후) → 응답 (또는 오류 시 → filter)
```

## 왜 중요한가

요청 생명주기 순서를 이해하는 것은 NestJS 애플리케이션을 올바르게 구축하는 데 기본적입니다 — 각 횡단 로직 조각이 정확히 *언제* 실행되는지 결정하며, 이는 설계 결정과 디버깅에 직접 영향을 미칩니다.

순서는 실제적이고 실무적인 의미를 가집니다: **guard가 pipe보다 먼저 실행**되므로 입력을 검증하기 전에 인가가 올바르게 확인됩니다(인가되지 않은 요청은 검증 전에 거부됨); **pipe가 핸들러 바로 직전에 실행**되어 핸들러가 항상 검증되고 변환된 인수를 받음을 보장합니다; **interceptor가 핸들러를 감쌈**(이전과 *이후* 실행)이 바로 실행 시간을 측정하고 응답을 변환하게 하는 요소입니다; 그리고 **exception filter가 모든 단계의 오류를 잡아** 중앙화된 오류 처리를 가능하게 합니다.

이 순서 — 그리고 범주 내 scope 순서(전역 → controller → 메서드) — 를 아는 것은 로직을 올바른 구성 요소에 배치하고, 실행 흐름을 예측하고, 무언가가 예상대로 실행되는(또는 실행되지 않는) 이유를 디버깅하고, 기능을 올바르게 설계하게 합니다.

이는 프레임워크의 모든 요청 처리 조각(middleware, guard, interceptor, pipe, filter)을 하나의 일관된 멘탈 모델로 묶어, NestJS가 요청을 처리하는 방식에 대한 진정한 이해를 반영하는 중요하고 자주 출제되는 주제입니다.