Spring Cloud Gateway 완전 가이드
Spring Cloud Gateway는 Spring WebFlux 기반의 API Gateway 프레임워크로, 마이크로서비스 환경에서 라우팅, 인증, 필터링, 트래픽 제어, 모니터링을 담당하는 핵심 플랫폼입니다.
Spring Cloud Gateway는 클라이언트 요청을 받아 적절한 마이크로서비스로 전달하는 API Gateway 역할을 수행합니다.
기존 Spring MVC 기반 Gateway와 달리 WebFlux와 Reactor 기반의 논블로킹 구조를 사용하여 높은 처리량과 낮은 리소스 사용량을 제공합니다.
목차
1. Spring Cloud Gateway란?
마이크로서비스 아키텍처(MSA)에서는 여러 개의 독립적인 서비스가 존재합니다.
예를 들어 쇼핑몰 시스템이라면 다음과 같은 서비스로 구성될 수 있습니다.
- 회원 서비스 (User Service)
- 상품 서비스 (Product Service)
- 주문 서비스 (Order Service)
- 결제 서비스 (Payment Service)
클라이언트가 각각의 서비스를 직접 호출하게 되면 인증, 라우팅, 로깅, 장애 처리 등의 공통 기능이 모든 서비스에 반복됩니다.
이 문제를 해결하기 위해 API Gateway를 두고 모든 요청을 Gateway를 통해 전달합니다.
⬇
Spring Cloud Gateway
(Route / Filter / Security / Monitoring)
⬇
Microservice 1 Microservice 2 Microservice N
Spring Cloud Gateway 특징
| 항목 | 설명 |
|---|---|
| WebFlux | 논블로킹 기반 고성능 요청 처리 |
| Routing | 요청 URL과 조건에 따른 서비스 전달 |
| Filter | 요청/응답 공통 처리 |
| Security | JWT, OAuth2 인증 처리 |
| Monitoring | Actuator, Micrometer 연동 |
2. API Gateway 아키텍처
일반적인 MSA 환경에서 Spring Cloud Gateway는 다음 위치에 배치됩니다.
↓
Load Balancer
↓
Spring Cloud Gateway
↓
User Service
Product Service
Order Service
Payment Service
Gateway가 담당하는 역할
- 클라이언트 요청 라우팅
- JWT 인증 및 권한 검사
- 요청 Header 변환
- 로그 및 Trace ID 생성
- Rate Limit 적용
- 장애 격리 처리
3. 주요 기능과 특징
Spring Cloud Gateway는 크게 Route, Predicate, Filter 세 가지 핵심 개념으로 동작합니다.
Route
어떤 요청을 어느 서비스로 전달할지 정의합니다.
Predicate
라우팅 조건을 정의합니다. URL, Header, Cookie, Method 등을 기준으로 판단합니다.
Filter
요청 전/후 공통 작업을 처리합니다. 인증, 로깅, Header 변경 등이 대표적입니다.
Spring Cloud Gateway 처리 흐름
Request
↓
Handler Mapping
↓
Route Predicate 검사
↓
Gateway Filter Chain
↓
Load Balancer
↓
Microservice
↓
Response Filter
↓
Client Response
4. 프로젝트 구성
5. Routing 설정
6. Predicate 상세
7. Gateway Filter
8. Global Filter
9. JWT 인증 구조
10. 운영 모니터링
'개발 가이드 > Spring Cloud' 카테고리의 다른 글
| Spring Cloud Gateway 완전 가이드 3 (0) | 2026.08.03 |
|---|---|
| Spring Cloud Gateway 완전 가이드 2 (0) | 2026.08.03 |
댓글