API 게이트웨이

이진일·2026년 4월 15일

TIL msa 내일배움캠프

내일배움캠프_단기심화7기

목록 보기

10/38

API 게이트웨이란?

API 게이트웨이는 클라이언트의 요청을 받아 백엔드 서비스로 라우팅하고 다양한 부가 기능을 제고하는 중간 서버이다.
클라이언트와 서비스 간의 단일 진입점 역할을 하며 보안, 로깅, 모니터링, 요청 필터링 등을 처리한다.

API 게이트웨이 주요 기능

라우팅: 클라이언트 요청을 적절한 서비스로 전달
인증 및 권한 부여: 요청의 인증 및 권한을 검증
로드 밸런싱: 여러 서비스 인스턴스 간의 부하 분산
모니터링 및 로깅: 요청 및 응답을 로깅하고 모니터링
요청 및 응답 변환: 요청과 응답을 변환하거나 필터링

Spring Cloud Gateway란?

Spring Cloud Gateway는 Spring 프로젝트의 일환으로 개발된 API 게이트웨이로 클라이언트 요청을 적절한 서비스로 라우팅하고 다양한 필터링 기능을 제공한다.
Spring Cloud Netflix 패키지의 일부로 MSA에서 널리 사용된다.

Spring Cloud Gateway의 주요 특징

동적 라우팅: 요청의 URL 패턴에 따라 동적으로 라우팅
필터링: 요청 전후에 다양한 작업을 수행할 수 있는 필터 체인 제공
모니터링: 요청 로그 및 메트릭을 통해 서비스 상태 모니터링
보안: 요청의 인증 및 권한 검증

라우팅 설정

application.yml


spring:
  cloud:
    gateway:
      discovery:
        locator:
          enabled: true  # 서비스 디스커버리를 통해 동적으로 라우트를 생성하도록 설정
      routes:
        - id: users-service  # 라우트 식별자
          uri: lb://users-service # 'users-service'라는 이름으로 로드 밸런싱된 서비스로 라우팅
          predicates:
            - Path=/users/** # /users/** 경로로 들어오는 요청을 이 라우트로 처리
        - id: orders-service  # 라우트 식별자
          uri: lb://orders-service  # 'orders-service'라는 이름으로 로드 밸런싱된 서비스로 라우팅
          predicates:
            - Path=/orders/** #/orders/** 경로로 들어오는 요청을 이 라우트로 처리

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/

위와 같이 설정하면 /users/** 경로로 들어오는 요청을 users-service라는 이름으로 로드 밸런싱된 서비스로 라우팅 처리한다.
/orders/** 경로로 요청이 들어오면 orders-service라는 이름으로 로드 밸런싱된 서비스로 라우팅 처리한다.

Spring Cloud Gateway 필터링

Global Filter: 모든 요청에 대해 작동하는 필터
Gateway Filter: 특정 라우트에만 적용되는 필터

필터를 구현하려면 GlobalFilter 또는 GatewayFilter 인터페이스를 구현하고 filter 메서드를 오버라이드해야 한다.

필터 객체 종류

Mono

Mono는 리액티브 프로그래밍에서 0또는 1개의 데이터를 비동기적으로 처리한다.
Mono<Void> 는 아무 데이터도 반환하지 않음을 의미한다.

ServerWebExchange

ServerWebExchange는 HTTP 요청과 응답을 캡슐화한 객체이다.
exchange.getRequest()로 HTTP 요청을 가져온다.
exchange.getResponse()로 HTTP 응답을 가져온다.

GatewayFilterChain

GatewayFilterChain은 여러 필터를 체인처럼 연결한다.
chain.filter(exchange)는 다음 필터로 요청을 전달한다.

필터 시점별 종류

Pre 필터

Pre 필터는 요청이 처리되기 전에 실행된다. 따라서 Pre 필터에서는 요청을 가로채고 필요한 작업을 수행한 다음, 체인의 다음 필터로 요청을 전달한다. 이때, 추가적인 비동기 작업을 수행할 필요가 없기 때문에 then 메서드를 사용할 필요가 없다.

Post 필터

Post 필터는 요청이 처리된 후, 응답이 반환되기 전에 실행된다. Post 필터에서는 체인의 다음 필터가 완료된 후에 실행되어야 하는 추가적인 작업을 수행해야 한다. 따라서 chain.filter(exchange)를 호출하여 다음 필터를 실행한 후, then 메서드를 사용하여 응답이 완료된 후에 실행할 작업을 정의한다.