😡 Spring WebClient로 통신 시 WebClientResponseException: 204 No Content from POST 에러 해결 방법

🚨 Error :

 

개발 도중에 디스코드 웹훅으로 알림 기능을 구현하는데 동작은 정상적으로 되나 위와 같은 에러가 계속 발생했다.


🤓 원인 :

 WebClient에 대해 깊게 알지 못한 상태에서 사용하여 꽤나 애를 먹었다. 결론부터 얘기하면 디스코드 웹훅은 응답 상태 코드로 204 No Content를 반환하고, WebClient에서 toEntity() 메서드는 200 대 상태 코드는 에러가 아니라고 판단하지만 204 상태 코드의 경우 에러라고 판단한다.

 

외부 서버와의 통신에서 api 응답 상태 코드를 임의로 변경하는 것은 불가능하므로 이에 대한 처리를 따로 해주면 된다.

 

return webClient
                .post()
                .uri(discordSecurityWebHookUrl)
                .header("Content-Type", "application/json")
                .bodyValue(json)
                .retrieve()
                .toEntity(String.class);

• 에러가 발생했던 기존 코드 내용이다.
• toEntity(Class<T> responseType) 메서드는 WebClient의 응답을 ResponseEntity<T>로 변환하는 역할을 한다.
• 즉, WebClient를 통해 HTTP 요청을 보낸 후 서버로부터의 응답을 ResponseEntity 객체로 감싸서 반환해준다.
• 그런데 toEntity 메서드는 응답 바디가 반드시 필요하다고 가정하므로 204 상태 코드가 반환되면 바디가 없기 때문에 예외가 발생한다.
• 이 경우 WebClient는 이를 에러로 간주하여 WebClientResponseException을 던진다.

 

🚒 해결 :

return webClient
        .post()
        .uri(discordSecurityWebHookUrl)
        .header("Content-Type", "application/json")
        .bodyValue(json)
        .retrieve()
        .bodyToMono(String.class) 
        .map(ResponseEntity::ok) 
        .onErrorResume(WebClientResponseException.class, ex -> {
            // 204 No Content 상태 코드 처리
            if (ex.getStatusCode() == HttpStatus.NO_CONTENT) {
                return Mono.empty(); // 204 상태코드인 경우 빈 Mono 반환
            }

            // 기타 에러 처리
            log.error("Error :", ex);
            return Mono.error(ex);
        });

.bodyToMono(String.class)

• toEntity는 상태코드 204를 처리할 수 없으니 bodyToMono로 응답 바디를 String으로 변환하여 Mono<String>을 반환하게 한다.

.map(ResponseEntity::ok)

• Mono<String> 값을 상태 코드 200 OK로 설정한 ResponseEntity<String>으로 변환한다.
• toEntity를 두 단계로 나눈 것이다.

.onErrorResume(WebClientResponseException.class, ex -> {...});

• 위의 상태로라면 다시 204 No Content로 인해 에러가 발생할 것이다. 그 에러를 처리하는 로직이다.

if (ex.getStatusCode() == HttpStatus.NO_CONTENT)

• 204 No Content일 경우 빈 모노를 반환하게 하고

return Mono.error(ex);

• 다른 400-500 대 에러가 발생하면 해당 에러를 출력하고 에러 정보를 리턴한다.

이렇게 변경하면 204 No Content로 응답이 와도 빈 Mono를 반환하여 에러가 발생되지 않게 막을 수 있다.

🤔 의문점 :

없음

 

 

 

참고

Chat GPT