스프링 클라우드 게이트 공식 문서에 따르면 필터 체인의 마지막에 Proxy Filter가 있고 해당 필터에서 프록시를 진행한다고 설명합니다. 이번 글에서는 스프링 클라우드 게이트웨이가 어떻게 프록시 필터를 구성하고 프록시를 진행하는지 알아보겠습니다.

Proxy 필터는 어디에 있는가?

스프링 클라우드 게이트웨이의 실제 Proxy 역할은 NettyRoutingFilter 와 NettyWriteResponseFilter 가 담당합니다.

NettyRoutingFilter

• 위치:
  • org.springframework.cloud.gateway.filter.NettyRoutingFilter
• 역할:
  • 클라이언트 요청을 실제 백엔드 서비스로 프록시 전송하는 핵심 필터
  • Netty의 HttpClient를 이용해 요청을 전송
  • HTTP Method, Headers, Body를 그대로 전달

NettyWriteResponseFilter

• 위치:
  • org.springframework.cloud.gateway.filter.NettyWriteResponseFilter
• 역할:
  • 백엔드로부터 수신한 응답을 클라이언트에게 전송(쓰기) 하는 역할
  • 응답 Body를 데이터 스트림으로 전달
  • 프록시 과정의 응답 처리 담당

필터 체인 내 실행 순서

스프링 클라우드 게이트웨이의 필터 체인에서 Proxy 동작 시점은 다음과 같습니다:

1. Pre 필터 (GlobalFilter, GatewayFilter): 인증, 로깅, 라우팅 결정 등의 선처리
2. NettyRoutingFilter:
   • Route 정보에 따라 백엔드 URI로 요청을 보냄
   • 백엔드와 연결 후 요청 전달

<aside> 💡

Route 정보란?

Route 정보(Route)는 현재 요청(Request)을 어떤 백엔드 서비스(URI)로 라우팅(프록시)할지 결정하기 위한 정보 객체입니다.

org.springframework.cloud.gateway.route.Route 객체로 표현되며, 다음 정보를 포함합니다:

• id: 라우트 식별자
• uri: 백엔드 서비스의 URI (ex: http://backend-service:8080)
• order: 라우트의 우선순위
• predicate: 해당 라우트가 적용될 조건 (Path, Method, Header 등 조건들)
• filters: 적용될 GatewayFilter 리스트
• metadata: 라우트와 연결된 추가 메타데이터

즉, “어떤 요청을 받았을 때 어떤 백엔드 URI로 전달하고, 어떤 필터 체인을 적용할지”의 결정된 결과입니다.

</aside>

1. NettyWriteResponseFilter:
   • 백엔드 응답을 읽어 클라이언트로 전달
   • 프록시 응답을 클라이언트에게 전달 완료
2. Post 필터 (GlobalFilter, GatewayFilter): 응답 수정, 로깅 등의 후처리 가능

Proxy 필터의 특징