[Spring] Unknown return value type: java.lang.Integer 오류

문제 상황

Spring로 블로그 포스트 생성 API를 개발하면서 컨트롤러 메서드에서 정수인 포스트 id값을 반환하려고 했는데 다음과 같은 오류가 발생했다.

Unknown return value type: java.lang.Integer

 

 

원인 분석

Spring에서 컨트롤러 메서드는 기본적으로 View(MVC 패턴의 View)의 이름을 반환한다고 간주한다. 즉, 메서드의 반환 값이 String이면, 그 값은 View의 이름으로 해석된다.

@GetMapping("/home")
public String home() {
    return "homePage";
}

예를 들어 위 코드에서 "homePage"는 View의 이름으로 해석되어서, Spring은 homePage.html 또는 homePage.jsp 같은 파일을 찾아서 렌더링한다.

 

하지만 Integer와 같은 기본 타입을 반환하는 경우, Spring은 이를 처리하는 방법을 모르기 때문에 Unknown return value type 오류를 발생시킨다.

 

 

해결 방법

@ResponseBody나 @RestController 어노테이션을 사용하여 Spring이 반환된 값을 View의 이름이 아닌, 데이터로 해석하고 HTTP 응답 본문에 포함시켜 반환하도록 한다.

 

• @ResponseBody

메서드의 반환값을 HTTP 응답 본문에 그대로 포함시키도록 한다. 즉, 반환된 데이터를 JSON 또는 XML 형식으로 직렬화하여 클라이언트에게 전송한다.

@Controller
public class MyController {

    @GetMapping("/example")
    @ResponseBody
    public String example() {
        return "Hello, World!";
    }
}

 

•  @RestController

@Controller와 @ResponseBody를 결합한 어노테이션으로, 해당 어노테이션이 붙은 클래스 내 모든 메서드는 기본적으로 @ResponseBody가 적용된 것으로 간주한다.

@RestController
public class MyRestController {

    @GetMapping("/example")
    public String example() {
        return "Hello, World!";
    }
}