[Spring Boot] unsupported media type 415 error (RequestBody, ModelAttribute, RequestParam) 오류

📌 상황

사용자로 String 값만을 받다가 이미지 파일까지 받기 위해 수정 후 오류가 발생...

"status": 415,
"error": "Unsupported Media Type",

📌 오류내용

원래 json형태로 String 타입인 title, content를 보낼 때는 정상적으로 작동을 했는데 클라이언트에서 String타입의 값들과 여러 이미지 파일을 동시에 서버로 보내기 위해 formdata로 변경하였더니 오류가 발생하였다.

📌 원인

@RequestBody에 관련된 오류였다. 오류 문구를 살펴보면 지원하지 않는 타입이라는 것을 알 수 있다. 문제를 해결하기 위해서는 먼저 "Content-Type"에 대해서 알아보자.

Content-Type이란

응답 내에 있는 Content-Type 헤더는 클라이언트에게
반환된 컨텐츠의 컨텐츠 유형이 실제로 무엇인지를 알려주는 역할을 한다.

즉, 응답헤더에 보내고자 하는 응답정보를 클라이언트에게 알려주는 것이다.

가장 많이 사용되는 유형은 3가지가 있다.
1. application/json

• 응답 데이터가 Json일 때 사용한다.

2. application/x-www-form-urlencoded

• form 의 데이터를 전송할 때 input의 값을 "key=value&key=value" 형식으로 만들어 요청을 서버에 날립니다.

3. multipart/form-data

• 응답 데이터에 파일이 첨부 될 수 있다.

📌 해결방법

클라이언트와 서버간 전송을 할 때 주로 다음과 같은 어노테이션을 사용한다.

• @RequestParam
• @RequestBody
• @ModelAttribute

@RequestParam

단일 데이터를 받기 위해서 사용한다.
Content-Type이 application/json 이든,mulipart/form-data 상관 없이 동일하게 key에 매칭되는 하나의 필드 값을 받을 수 있다.

@RequestBody

클라이언트가 전송한 Json 형태의 데이터를 Java의 객체로 변환시켜준다.
Content-Type이 application/json이어야 한다.

@ModelAttribute

form 데이터 (문자, 이미지파일 등)을 받기 위해서 사용한다.
Content-Type이 multipart/form-data 인 데이터를 받는다.
이 때 @ModelAttribute 는 클라이언트가 전송한 데이터를 Java 객체와 바인딩하기 위해서 Setter 를 호출하기에 Setter 가 있어야 한다.

📌 결론

@ReqeustBody의 Content-Type은 application/json 형식을 받을 수 있다고 나와있었다.
하지만 Postman에서 보내고자 하는거는 multipart/form-data 형식으로 보내고 있었다.
multipart/form-data 형식을 DTO로 받으려면 @ModelAttribute로 받아야한다!!