1️⃣ 정의

💻 WebClient

• Spring Boot에서 제공하는 고수준(High-level) 비동기·논블로킹 기반 HTTP 클라이언트
• Spring WebFlux 기반
• 응답 모델 자동 역직렬화 (Jackson 등)
• 메소드 체이닝 방식

📡 HttpClient

• 저수준(Low-level) 비동기 HTTP 클라이언트
• Reactor-Netty 기반
• 응답은 ByteBuf/ByteBuffer 형태로 제공 → JSON은 직접 파싱 필요
• 커넥션 풀, 타임아웃, SSL 등 세부 튜닝 가능

🧩 ReactorClientHttpConnector

• WebClient와 HttpClient를 연결하는 어댑터/브리지 역할
• HttpClient에서 세부 설정한 후, 이를 WebClient에 주입

2️⃣ 주요 차이점

3️⃣ 장단점

💻 WebClient

장점 ✅

• 자동 직렬화/역직렬화
• 필터, 리트라이, 백프레셔 등 리액티브 패턴 쉽게 구현
• 코드 간결

단점 ⚠️

• 세부 네트워크 설정은 HttpClient 의존
• 리액티브 프로그래밍 러닝 커브 존재

📡 HttpClient

장점 ✅

• 세부 네트워크 설정 가능(ConnectionProvider, 타임아웃, TLS, 프록시 등)
• 대규모 트래픽·특수 프로토콜에 대응 가능

단점 ⚠️

• JSON 파싱, 에러 처리, 리트라이 직접 구현 필요
• 코드 복잡도 증가

4️⃣ HttpClient + WebClient & ReactorClientHttpConnector 실전 예시

    /**
     * 공통 커넥션 풀 설정 (커넥션 재사용을 위함)
     */
    @Bean
    public ConnectionProvider connectionProvider() {
        return ConnectionProvider.builder("test-pool")
                .maxConnections(100)
                .pendingAcquireMaxCount(500)
                .pendingAcquireTimeout(Duration.ofSeconds(30))
                .build();
    }
    
    
    
    
    /**
     * Webclient 정의 (ReactorClientHttpConnector 활용하여
     */
    @Bean
    public HttpClient createHttpClient(ConnectionProvider connectionProvider) {
    
        SslContext sslContext;
        try {
            sslContext = SslContextBuilder.forClient().build();
        } catch (SSLException e) {
            throw new CustomRuntimeException(ErrorEnum.SSL_CONTEXT_ERROR);
        }
        return HttpClient.create(connectionProvider)
                .secure(sslContextSpec -> sslContextSpec.sslContext(sslContext).handshakeTimeout(Duration.ofSeconds(30)))
                .responseTimeout(Duration.ofSeconds(90))
                .doOnConnected(conn -> conn
                        .addHandlerLast(new ReadTimeoutHandler(90))
                        .addHandlerLast(new WriteTimeoutHandler(5)));
                        
    }    
   
   

    /**
     * 공통 HttpClient (응답 타임아웃 설정 포함)
     */    
    @Bean
    public WebClient testWebClient(HttpClient httpClient) {

        DefaultUriBuilderFactory factory = new DefaultUriBuilderFactory("https://example.com/test");
        factory.setEncodingMode(DefaultUriBuilderFactory.EncodingMode.VALUES_ONLY);

        //WebClient 기본 버퍼가 256KB 때문에 초과하면 BufferLimitException 발생
        return WebClient.builder()
                .clientConnector(new ReactorClientHttpConnector(httpClient))
                .uriBuilderFactory(factory)
                .baseUrl("https://example.com/test")
                .exchangeStrategies(ExchangeStrategies.builder()
                        .codecs(configurer -> configurer
                                .defaultCodecs()
                                .maxInMemorySize(10 * 1024 * 1024)) // ✅ 최대 10MB
                        .build())
                .build();
    }

5️⃣ Mono 기반의 비동기·논블로킹 호출

@Component
@RequiredArgsConstructor
public class TestProvider {


	private final WebClient testWebClient;


    /**
     * Mono 활용한 비동기 호출
     */
    private Mono<TestDTO> test() {

        return testWebClient.get()
                .uri(uriBuilder -> uriBuilder
                        .queryParam("serviceKey", "testKey")
                        .queryParam("pageNo", 1)
                        .queryParam("numOfRows", 1000)
                        .queryParam("returnType", "JSON")
                        .build())
                .retrieve()
                .bodyToMono(TestDTO.class)
                .doOnError(TimeoutException.class, e -> log.error("⏳ TimeoutException 발생 : {}", e.getMessage()))
                .doOnError(IllegalStateException.class, e -> log.error("⏳ IllegalStateException 발생 : {}", e.getMessage()))
                .doOnError(WebClientResponseException.class, e -> log.error("⏳ WebClientResponseException 발생 : {}", e.getMessage()))
                .retryWhen(Retry.fixedDelay(5, Duration.ofSeconds(5))
                        .filter(throwable -> throwable instanceof TimeoutException || throwable instanceof IllegalStateException || throwable instanceof WebClientResponseException)
                        .doBeforeRetry(retrySignal -> {
                            Throwable failure = retrySignal.failure();
                            log.warn("🔁 [ 테스트 서드파티  {}회차 재시도] 이유: {}",
                                    retrySignal.totalRetries() + 1,
                                    failure.getMessage());
                        }));
    }
}

결론 🎯

• 일반적인 REST API 호출 → WebClient 단독 사용
• 세밀한 네트워크 제어 필요 시 → HttpClient 설정 후 ReactorClientHttpConnector로 WebClient에 주입