📖 개요

Spring Cloud Gateway
클라이언트 요청을 받아 내부 마이크로서비스로 전달하는 API Gateway

왜 사용하는지

• 서비스가 여러 개일 때 단일 진입점 구성 필요
• 인증, 로깅, 필터링 공통 처리
• 서비스 주소(IP/Port) 숨기기 가능

해결하는 문제

• 서비스별 URL 직접 호출 문제 해결
• 공통 로직 중복 제거
• 라우팅 및 로드밸런싱 중앙 관리

핵심 특징

• URL 기반 라우팅 처리
• Predicate + Filter 구조
• Eureka 연동 시 서비스 이름으로 호출 가능

⚙️ 핵심 개념

1️⃣ 라우팅 (Routing)

요청 URL 기준으로 서비스 분기 처리

Client → Gateway → Service

2️⃣ Predicate (조건)

요청을 어떤 서비스로 보낼지 결정

• Path
• Method
• Header

3️⃣ Filter (요청/응답 처리)

Gateway에서 요청 전/후 로직 수행

• 요청 로깅
• 응답 로깅
• 인증 처리
• 헤더 변경

4️⃣ Eureka 연동

서비스 이름으로 호출 가능

lb://PRODUCT-SERVICE

🔍 동작 원리

전체 흐름

Client 요청
→ Gateway 수신
→ Predicate 조건 확인
→ Filter (요청 전 실행)
→ 서비스 호출 (Eureka 조회)
→ Filter (응답 후 실행)
→ Client 응답

Microservices

• Product Service
• Order Service

💻 코드 예시

1️⃣ application.yml 설정

spring:
cloud:
gateway:
routes:
- id: product-service
uri: lb://PRODUCT-SERVICE
predicates:
- Path=/products/**

    - id: order-service
      uri: lb://ORDER-SERVICE
      predicates:
        - Path=/orders/**

2️⃣ Global Filter (기본 구조)

@Component
public class LoggingFilter implements GlobalFilter, Ordered {

@Override
public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {

    ServerHttpRequest request = exchange.getRequest();
    System.out.println("Request URI: " + request.getURI());

    return chain.filter(exchange)
            .then(Mono.fromRunnable(() -> {
                ServerHttpResponse response = exchange.getResponse();
                System.out.println("Response Status: " + response.getStatusCode());
            }));
}

@Override
public int getOrder() {
    return -1;
}

}

🚀 사용 방법 정리

1️⃣ Gateway에서 API 사용하는 구조

• 클라이언트는 Gateway만 호출
• Gateway가 내부 서비스로 전달

예시

Client → /products/1 요청
→ Gateway
→ product-service 호출
→ 응답 반환

2️⃣ 실제 API 호출 흐름

GET /products/1

→ Gateway
→ Predicate 매칭 (/products/**)
→ product-service로 라우팅
→ 응답 반환

3️⃣ 필터 동작 위치

요청 → [Request Filter] → Service → [Response Filter] → 응답

➕ 필터 복사 재사용 꿀팁

필터는 구조가 동일하기 때문에 그대로 복사해서 사용 가능

사용 방법

• 기존 필터 클래스 복사
• 클래스 이름 변경
• 필요한 로직만 수정

예시 (응답 로깅만 변경)

@Component
public class ResponseLoggingFilter implements GlobalFilter, Ordered {

    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {

        return chain.filter(exchange)
                .then(Mono.fromRunnable(() -> {
                    ServerHttpResponse response = exchange.getResponse();
                    System.out.println("Custom Response Log: " + response.getStatusCode());
                }));
    }

    @Override
    public int getOrder() {
        return -2;
    }
}

핵심 정리

• 필터 구조 동일 → 복사해서 바로 사용 가능
• 요청/응답 로직만 분리해서 수정
• 공통 로직 빠르게 확장 가능

🧠 TIL (Today I Learned)

• Gateway는 모든 요청의 진입점 역할 수행
• Predicate로 서비스 라우팅 처리
• Filter로 공통 로직 처리 가능
• Eureka 연동 시 서비스 이름 기반 호출 가능
• 필터는 복사 후 일부 로직만 수정해서 재사용 가능