[Spring] API gateway

API Gateway란?

• MSA 에서 모든 클라이언트 요청의 단일 진입점 역할을 하는 서버
• Spring에서는 보통 Spring Cloud Gateway를 사용
• 클라이언트 -> Gateway -> 내부 서비스들
• 서비스들은 외부에 직접 노출되지 않음

 

 

API Gateway의 필요성

• 서비스 직접 노출의 문제
  • 서비스가 많아질수록 엔드포인트 관리 어려움
  • 인증/인가 로직이 각 서비스에 중복
  • CORS, 로깅, 모니터링 분산
• Gateway가 해결하는 것
  •  공통 관심사 중앙화
  • 보안/인증 일관성 확보
  • 클라이언트는 Gateway만 알면 됨

 

Spring Cloud Gateway 핵심 역할

• 요청 라우팅 (Routing)
  • URL, Header, Method 기준으로 서비스 분기
  • /members/** -> member-service
• 인증/인가
  • JWT 검증
  • 토큰 없으면 서비스 진입 차단
• 필터 처리
  • 요청 전, 후 공통 로직
  • 로깅, 헤더 추가, 권한 체크 등
• 트래픽 제어

 

Gateway 동작 흐름

1. 클라이언트 요청 수신
2. Predicate로 라우팅 대상 결정
3. Pre Filter 실행
4. 실제 서비스로 요청 전달
5. Post Filter 실행
6. 응답 반환

 

주요 개념 정리

• Route
  • id : 라우트 식별자
  • uri : 목적지 서비스
  • predicates : 요청 조건

spring:
  cloud:
    gateway:
      routes:
        - id: member-service
          uri: lb://MEMBER-SERVICE
          predicates:
            - Path=/members/**

 

• Predicate
  • 요청을 어떤 서비스로 보낼지 결정하는 조건

- Path=/api/orders/**
- Method=POST

 

• Filter
  • 요청/응답을 가공하는 로직
    • Global Filter : 모든 요청 공통
    • Custom Filter : 특정 라우트 전용
    • 예 : JWT 검증, 사용자 정보 헤더에 주입, 응답 로깅

 

Spring Cloud Gateway의 특징

• Non-Blocking (WebFlux 기반)
  • 고성능, 고동시성 처리에 유리
• Spring 생태계와 궁합 좋음
  • Eureka, Config Server 연동
  • OAuth2, JWT 연계 쉬움
• 코드 + 설정 기반 모두 가능
  • YML로 간단 구성

 

Gateway vs Nginx

구분	Spring Cloud Gateway	Nginx
목적	MSA 내부 라우팅	L7 프록시
인증/인가	매우 유연	제한적
비즈니스 로직	가능	불가능
러닝커브	있음	낮음

 

 

언제 사용하면 좋을까?

• 서비스가 3개 이상
• 인증/인가 공통 처리 필요
• MSA 구조 도입 단계
• 클라이언트 종류가 여러 개 (웹/앱)