🛠️ NestJS Middleware 완전 정복 – 요청 전처리, 로깅, 인증 필터의 핵심

🛠️ NestJS Middleware 완전 정복 – 요청 전처리, 로깅, 인증 필터의 핵심

---

NestJS에서 **Middleware(미들웨어)**는 HTTP 요청이 Controller에 도달하기 전에 실행되는 함수입니다.
이 글은 NestJS 공식 문서의 Middleware를 한글 번역 + 실무 중심 해설로 풀어낸 블로그입니다.

로깅, 인증, 요청 조작 등 모든 "전처리 작업"은 Middleware에서 처리하는 것이 정석입니다.

---

✅ Middleware란?

NestJS의 Middleware는 다음과 같은 역할을 수행합니다:

• 요청 로깅
• 인증 토큰 검증
• 요청 객체(req) 가공
• 특정 라우트 접근 제한

Express와 매우 유사한 구조를 가지며, 내부적으로 Express 기반 미들웨어도 사용할 수 있습니다.

---

1️⃣ 기본 Middleware 구조

import { Injectable, NestMiddleware } from '@nestjs/common';
import { Request, Response, NextFunction } from 'express';

@Injectable()
export class LoggerMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    console.log(`[요청] ${req.method} ${req.originalUrl}`);
    next(); // 반드시 호출!
  }
}

• NestMiddleware 인터페이스 구현
• use() 메서드 안에서 원하는 작업 수행 후 next() 호출

---

2️⃣ Middleware 등록하기 (forRoutes)

Middleware는 Module에서 configure() 메서드 내에 등록합니다.

import { MiddlewareConsumer, Module, NestModule } from '@nestjs/common';

@Module({})
export class AppModule implements NestModule {
  configure(consumer: MiddlewareConsumer) {
    consumer
      .apply(LoggerMiddleware)
      .forRoutes('*'); // 모든 라우트에 적용
  }
}

실무 팁

• forRoutes('*'): 전체 라우트에 적용
• 특정 컨트롤러 혹은 메서드만 적용하고 싶을 땐:

.forRoutes({ path: 'cats', method: RequestMethod.GET })

---

 

반응형

이 구간은 실전 적용 직전으로 애드센스 광고 클릭률이 매우 높은 구간입니다.

<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-XXXXXX"
     data-ad-slot="YYYYYY"
     data-ad-format="auto"
     data-full-width-responsive="true"></ins>

---

3️⃣ 미들웨어에서 요청 데이터 조작

use(req: Request, res: Response, next: NextFunction) {
  req.headers['x-custom-header'] = 'PoweredByNestJS';
  next();
}

이렇게 하면 이후 Controller에서는 req.headers['x-custom-header'] 값을 사용할 수 있습니다.

---

4️⃣ 여러 Middleware 동시에 적용하기

consumer
  .apply(AuthMiddleware, LoggerMiddleware)
  .forRoutes('cats');

NestJS는 여러 개의 미들웨어를 체인 형태로 등록할 수 있습니다.
순서대로 실행되며, next() 호출을 잊으면 후속 미들웨어가 실행되지 않습니다.

---

5️⃣ 전역 미들웨어 등록 (Express 방식)

Nest 애플리케이션 레벨에서 직접 등록도 가능합니다:

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.use((req, res, next) => {
    console.log('전역 미들웨어');
    next();
  });
  await app.listen(3000);
}

단점: DI 불가능 → Nest 의존성을 주입할 수 없음
권장 방식은 @Injectable()을 사용한 DI 기반의 Nest Middleware입니다.

---

6️⃣ 실무 예제: JWT 토큰 인증 미들웨어

@Injectable()
export class AuthMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    const token = req.headers['authorization'];
    if (!token) {
      return res.status(401).json({ message: '인증 필요' });
    }
    // 토큰 검증 로직 추가 가능
    next();
  }
}

Tip: 인증은 Middleware에서 1차적으로 확인하고, 세부 권한은 Guard에서 처리하는 구조가 이상적입니다.

---

🧠 실무 설계 전략

구분 사용 위치 설명

LoggerMiddleware	전역 or 특정 라우트	요청 로그 기록
AuthMiddleware	인증 필요한 경로	JWT 토큰 검증
RawBodyMiddleware	Webhook 처리 시	req.rawBody 추출

---

🔚 마무리 요약

• Middleware는 컨트롤러 전에 실행되는 가드 역할
• @Injectable() + configure()로 등록
• next() 호출 필수
• 인증, 로깅, 요청 가공 등에 매우 유용
• Nest + Express 미들웨어 호환 가능

다음 글에서는 Pipe와 Validation을 통해 요청 데이터를 안전하게 처리하는 방법을 안내드릴 예정입니다.

---

 

NestJS Middleware,NestJS 미들웨어 적용,NestJS 로깅,NestJS 인증,NestJS 요청 가공,NestJS 전역 미들웨어,NestJS DI 기반 미들웨어,NestJS JWT 인증,NestJS 실전 예제,NestJS 백엔드 구조

---

다음 편에서는 Pipe와 유효성 검증 패턴으로 이어집니다. 원하시면 바로 작성해드릴게요! 😊