NIO 기반으로 동작하는 WebFlux에서 어떤 시점에 핸들러를 통해 만들어진 응답을 클라이언트에게 전송하는지 알아보겠습니다.

WebFlux 요청 처리 구조

• 클라이언트가 HTTP 요청을 보냄
• Netty의 EventLoop가 요청 수신 → HttpServerHandler → Reactor Netty → DispatcherHandler로 위임
• DispatcherHandler가 HandlerMapping → HandlerAdapter를 통해 Handler 호출
• Handler는 ServerResponse(or ResponseEntity) 등을 만들어 Mono<ServerResponse> 형태로 반환

응답 전송 시점

핸들러가 Mono<ServerResponse>를 반환하는 시점이 아니라, 해당 Mono가 subscribe()되어 구독되며 데이터가 전달될 때 실제 응답 전송이 시작됩니다.

WebFlux에서는:

• 핸들러 반환 → DispatcherHandler가 이 Mono를 구독
• 구독 시 내부적으로 ServerHttpResponse의 body에 writeWith로 DataBuffer를 쓰기 시작
• 이때 Netty의 채널에 데이터를 기록하기 시작하면서 실제로 클라이언트에게 전송됩니다.

즉, 응답 바디를 구성하는 Publisher가 emit하여 Netty의 채널에 write될 때 클라이언트로 전송이 시작됩니다.

HandlerResultHandler

HandlerResultHandler의 역할

• WebFlux의 DispatcherHandler는 핸들러가 반환한 결과(Mono<ServerResponse>, Mono<Rendering>, 단일 값 등) 을 HandlerResult로 감싸서 처리합니다.
• 이때 HandlerResultHandler가 개입하여:
  • 이 HandlerResult를 어떻게 응답으로 변환할지 결정
  • 응답 변환 및 쓰기 작업을 진행
• 즉, 응답의 작성 및 전송을 트리거하는 역할을 담당합니다.