[NestJS] 요청 라이프사이클 완전 정리: 미들웨어부터 인터셉터까지

• 특정 사무실(컨트롤러)에 들어가기 직전, 복도에 있는 보안 장치입니다.
• "개발팀 사무실이군요? 카드키(JWT 토큰)를 찍어 주세요. 권한이 없으면 들어갈 수 없습니다."

라이프사이클 상세 분석

Middleware: 가장 바깥쪽의 필터

미들웨어는 요청(req)과 응답(res) 객체 사이에서 동작하는 함수입니다.

• 핵심: next()를 호출해 다음 단계로 넘기거나, 응답을 종료할 수 있습니다.
• 활용: CORS, 공통 로깅, 바디 파싱.

Guard: 인가(Authorization) 계층

가드는 미들웨어와 달리 실행될 메서드의 정보(Context)를 알고 있습니다.

• 핵심: canActivate()가 true일 때만 컨트롤러로 진입을 허용합니다.
• 활용: JWT 토큰 검증, Role 기반 접근 제어(RBAC).

Interceptor: 전후처리 마술사

RxJS를 활용해 비동기 흐름을 제어하고 응답 데이터를 변형합니다.

• 활용: 응답 포맷 통일, 캐싱, 로깅 시작/종료 처리.

Pipe: 데이터 정제 및 역직렬화

컨트롤러 인자를 대상으로 변환(Transformation)과 검증(Validation)을 수행합니다.

• 활용: ValidationPipe를 이용한 DTO 검증, ParseIntPipe를 이용한 형변환.

핵심 비교 요약

마치며

NestJS의 요청 라이프사이클을 이해한다는 것은 "책임의 분리"를 실천한다는 뜻입니다. 적절한 로직을 적절한 위치(미들웨어, 가드, 파이프 등)에 배치하면 코드는 자연스럽게 깨끗해지고 유지보수도 쉬워집니다.

각 단계의 존재 이유를 명확히 이해하고, 프로젝트에 맞는 파이프라인을 설계해 보시기 바랍니다.

참고 자료

• NestJS 공식 문서 - Request Lifecycle
• Express Middleware Guide