NestJS의 middleware란 무엇이며 guard/interceptor와 어떻게 다른가요?

Question

Accepted Answer

**Middleware**는 request와 response 객체에 접근하면서 **라우트 핸들러보다 먼저 실행되는** 함수입니다 — Express middleware와 동일한 개념입니다. NestJS에는 guard, interceptor, pipe, filter도 있으며, 각각 요청 생명주기의 특정 지점에서 고유한 목적으로 실행됩니다. 어떤 것을 사용할지 아는 것이 핵심입니다.

## Middleware — 가장 먼저 실행, req/res 접근

```ts
@Injectable()
export class LoggerMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    console.log(`${req.method} ${req.url}`);   // 로깅, req 수정
    next();                                      // 계속하려면 next()를 반드시 호출
  }
}

// module에 등록
export class AppModule implements NestModule {
  configure(consumer: MiddlewareConsumer) {
    consumer.apply(LoggerMiddleware).forRoutes("*");   // 라우트에 적용
  }
}
```

Middleware는 guard/interceptor/pipe보다 먼저 가장 일찍 실행되며 원시 `req`/`res`로 작동합니다 — 로깅, 요청 수정, CORS, Express 호환 관심사에 적합합니다.

## 전체 요청 생명주기 순서

```text
요청 →
  1. Middleware     (req/res; 가장 먼저 실행, Express 스타일)
  2. Guard          (true/false 반환 → 요청을 인가하거나 차단)
  3. Interceptor    (핸들러 이전)
  4. Pipe           (핸들러 인수 검증/변환)
  5. → 라우트 핸들러 ←
  6. Interceptor    (핸들러 이후 — 응답 변환)
  7. Exception Filter (어딘가에서 오류가 던져진 경우)
→ 응답
```

## 각각이 무엇을 위한 것인가 (올바른 도구 선택)

```text
Middleware  → req/res를 사용한 일반적인 전처리 (로깅, CORS, 원시 요청 작업)
Guard       → 인가(AUTHORIZATION) — 요청 진행 여부 결정 (인증, 역할)
              (true 반환 = 허용, false/throw = 차단)
Interceptor → 핸들러를 감쌈 — 요청/응답 변환, 로깅/캐싱/타이밍 추가
              (핸들러 이전과 이후에 로직 실행 가능)
Pipe        → 핸들러 입력 인수 검증/변환 (DTO 검증)
Filter      → 예외를 잡아 응답으로 포맷
```

핵심 구분: middleware는 일반적인 Express 스타일 전처리; **guard**는 특히 인가를 처리(인증을 위한 깔끔하고 전용적인 위치, middleware에 욱여넣는 것과 달리); **interceptor**는 핸들러를 감싸 응답을 변환하거나 횡단 동작을 추가; **pipe**는 입력을 검증; **filter**는 오류를 처리.

## middleware 대 guard 대 interceptor를 언제 사용하나

```text
인증 확인?           → Guard (전용, execution context 있음, boolean 반환)
요청 로깅?           → Middleware 또는 interceptor (interceptor는 응답도 봄)
응답 변환?           → Interceptor (핸들러 이후 실행)
DTO 검증?            → Pipe
원시 req 조기 수정?  → Middleware
```

## 왜 중요한가

Middleware와 그것이 guard, interceptor, pipe, filter와 어떻게 다른지 이해하는 것은 NestJS 애플리케이션을 올바르게 구조화하는 데 필수적입니다 — 각각은 특정 역할을 가지며 요청 생명주기의 특정 지점에서 실행되고, 올바른 것을 사용하면 깔끔하고 관용적인 코드로 이어집니다.

Middleware는 원시 req/res로 일반적인 Express 스타일 전처리를 처리합니다.

결정적인 구분은 **guard**가 인가(인증/역할)를 위한 전용의 적절한 위치라는 것(그 목적에 middleware보다 훨씬 깔끔함)과, **interceptor**가 핸들러를 감싸 응답을 변환하고 middleware가 쉽게 할 수 없는 횡단 관심사(로깅, 캐싱, 타이밍)를 추가한다는 것입니다(middleware는 핸들러보다 먼저 실행되고 응답을 자연스럽게 보지 못하므로).

전체 생명주기 순서(middleware → guard → interceptor → pipe → 핸들러 → interceptor → filter)와 어떤 도구가 각 관심사에 맞는지(인증 → guard, 응답 변환 → interceptor, 검증 → pipe, 오류 → filter)를 아는 것은 NestJS 역량의 특징이며, middleware를 모든 것에 오용하는 흔한 실수를 방지합니다.

이는 프레임워크에서 자주 출제되고 아키텍처적으로 중요한 주제입니다.