HTTP 204 (NO CONTENT) 알고 쓰자

프로젝트를 진행하면서 사용자의 응답 요청은 정상적으로 오지만 유튜브의 음악이 존재하지 않을 경우 204 code로 response를 반환하기로 했다.

 

@GetMapping("/search/youtube")
    public ResponseEntity<?> searchMusicByYoutube(@RequestParam String musicTitle,
                                                  @RequestParam String musicArtist, @RequestParam long spotifyMusicDuration,
                                                  @RequestParam String musicImageUrl, @RequestParam String spotifyId) {
        Map<String, Object> result = musicService.findVideo(musicTitle, musicArtist, spotifyMusicDuration, musicImageUrl, spotifyId);

        System.out.println(result.toString());
        if(result.containsKey("code")){
            return ResponseEntity.status(HttpStatus.NO_CONTENT).body(result);
        }else{
            return ResponseEntity.status(HttpStatus.OK).body(result);
        }
    }

위 코드를 보면 key값으로 code가 포함돼있으면 NO_CONTENT인 204를 응답하고 제대로 있을 경우 200을 보내주기로 했다.

if의 경우 map에

if (result.getMusicYoutubeId() == null) {
                out.put("code", 204);
                out.put("message", "조건에 맞는 영상을 찾을 수 없습니다.");
                return out;
            }

해당 값을 담아서 프론트로 전송했으나

 

body에 Map이 담겨서 전송되지 않는 문제가 발생했었다.

 

의도한대로라면 data에 JSON 형식으로 값이 담겨있어야하는데... 대체 왜 안되는지 몰라서 204 코드에 대해 찾아보게 되었다.

 

204 NO_CONTENT

https://developer.mozilla.org/ko/docs/Web/HTTP/Status/204

204 No Content - HTTP | MDN

모질라에서 주의해야한다고 적어놓은 내용은 아래와 같다.

이 상태코드는 본문 없는 응답을 위한 상태 코드이지만, 서버에서 잘못되게 본문을 포함한 응답을 전달하는 경우가 존재할 수 있습니다. 이 프로토콜은 사용자 에이전트 다양한 방법으로 처리하는 것을 허용하고 있습니다. 이에 대한 토론은 여기서 확인할 수 있습니다. 보통 지속 연결에서 볼 수 있는 문제로, 잘못 포함된 본문이 이후 요청에 대한 별도의 응답을 담고 있을 수 있습니다. Apple Safari는 잘못 포함된 모든 데이터를 거부합니다. Google Chrome과 Microsoft Edge는 잘못된 데이터의 최대 4바이트를 검사한 후, 유효한 별도의 요청을 찾지 못한 경우 폐기합니다. Firefox는 1킬로바이트 이상을 검사합니다.
같이 보

 

즉 204코드는 response body를 보여주지 않는다!!

결국 필자는 200코드로 변경해서 data를 보내주기로 결정했다.

 

200으로 변경하고나서는 data에 잘 담겨지는 것을 확인할 수 있다.