spring boot ) WebClient DataBufferLimitException 오류 해결 방법

Spring WebClient로 API 호출을 하다 보면 다음과 같은 오류를 만날 수 있어요.

DataBufferLimitException: Exceeded limit on max bytes to buffer : 262144

 

 

이게 뭐냐면,

WebClient가 응답 데이터를 메모리에서 버퍼링하는데 기본 제한이 256KB(262,144 bytes)로 설정되어 있어서, API에서 너무 큰 데이터를 보내주면 "나 너무 커서 못 받겠어!" 하고 에러를 내뱉는 거예요.

이럴 때 해결 방법은 간단합니다. 버퍼 크기를 늘려주면 끝!

다음과 같이 WebClient 설정 시 maxInMemorySize 옵션을 넣어주면 됩니다.

return WebClient.builder()
    .clientConnector(new ReactorClientHttpConnector(httpClient))
    .baseUrl(baseUrl)
    // 🔧 버퍼 크기 증가: 256KB → 10MB (대용량 응답 데이터 처리)
    .codecs(configurer -> configurer
        .defaultCodecs()
        .maxInMemorySize(10 * 1024 * 1024)) // 10MB
    .build();

 

이렇게 설정해주면 최대 10MB까지 데이터를 한 번에 받을 수 있어서 대용량 JSON, 이미지 URL 리스트, 엑셀 파일 데이터 등 API 응답이 큰 경우에도 에러 없이 처리할 수 있어요.

하지만 주의사항! 🚫

• 무작정 너무 큰 용량으로 설정하면 서버 메모리를 많이 잡아먹어 OutOfMemory가 날 수 있으니, API 응답 예상 크기에 맞게 적당히 설정하세요.
• 진짜 너무 큰 데이터는 스트리밍 처리나 파일 다운로드 방식으로 처리하는 것이 더 안전합니다.

이렇게 DataBufferLimitException 에러는 쉽게 해결할 수 있으니, 만약 Spring WebClient에서 대용량 응답 처리 중 막혔다면 위처럼 설정해보세요!

---

#SpringBoot #WebClient #DataBufferLimitException #Spring오류해결 #스프링팁 #개발자일상 #코딩공부 #스프링웹클라이언트