# Spring MVC 파라미터 바인딩 정리: @PathVariable, @RequestParam, @RequestBody

Spring Boot로 REST API를 만들다 보면,

클라이언트에서 넘어오는 데이터를 컨트롤러에서 어떻게 받아야 할지 헷갈릴 때가 많습니다.
특히 @PathVariable, @RequestParam, @RequestBody는

각각 쓰임새가 다르지만 비슷해 보여서 처음에는 혼동하기 쉽습니다.

이번 글에서는 세 어노테이션의 차이점을 표로 정리하고, 상황별로 어떤 것을 선택하면 좋은지 알아보겠습니다.

---

비교 표

어노테이션	값이 오는 위치	예시 요청	컨트롤러	코드 바인딩 결과
@PathVariable	URL 경로	GET /boards/10	@GetMapping("/boards/{boardId}")public String get(@PathVariable int boardId)	boardId = 10
@RequestParam	URL 쿼리스트링(?key=value)	GET /boards?page=2&size=10	@GetMapping("/boards")public String list(@RequestParam int page, @RequestParam int size)	page = 2, size = 10
@RequestBody	HTTP Body (JSON, XML 등)	POST /boardsBody: { "title": "제목", "content": "내용" }	@PostMapping("/boards")public void add(@RequestBody BoardDTO dto)	dto.title = "제목"dto.content = "내용"

---

각 어노테이션의 특징

• @PathVariable
  • URL 경로에 포함된 값을 변수로 매핑.
  • REST API에서 자원의 고유 ID를 나타낼 때 적합.
  • 예: /boards/10 → 게시글 번호 10 조회.
• @RequestParam
  • 쿼리스트링 형태로 전달되는 값을 매핑.
  • 검색 조건, 페이징 같은 옵션성 값에 적합.
  • 기본적으로 필수지만 required=false 옵션으로 선택적으로 받을 수도 있음.
• @RequestBody
  • HTTP Body에 담긴 JSON, XML 데이터를 DTO로 변환.
  • 클라이언트가 보낸 데이터를 객체 형태로 받아서 처리할 때 사용.
  • 보통 POST, PUT 요청에서 많이 활용됨

---

활용 예시: 댓글 등록 API

@PostMapping("/boards/{boardId}/comments")
public void addComment(@PathVariable int boardId,      // URL에서 게시글 ID
                       @RequestBody CommentDTO comment, // JSON Body에서 댓글 내용
                       @AuthenticationPrincipal CustomUser user) { // 로그인 사용자
    comment.setBoardId(boardId);
    comment.setUserId(user.getUserDTO().getUserId());
    commentService.addComment(comment);
}

 

 

• @PathVariable → 어떤 게시글(boardId)에 달린 댓글인지 구분
• @RequestBody → 댓글 내용(content, parentId) 받음
• @AuthenticationPrincipal → 로그인한 사용자 정보에서 userId 가져오기

---

결론

• @PathVariable은 URL 경로 값
• @RequestParam은 쿼리스트링 값
• @RequestBody는 HTTP Body(JSON/XML) 값

세 가지를 적절히 조합하면 REST API를 훨씬 명확하게 설계할 수 있습니다.
특히 게시판, 댓글 같은 기능을 만들 때는 @PathVariable로 자원을 구분하고,

@RequestBody로 실제 데이터를 받아 처리하는 패턴이 가장 많이 쓰입니다.

Spring MVC에서 이 세 가지 개념을 정확히 구분해두면, 이후 API 개발할 때 훨씬 깔끔한 코드를 작성할 수 있습니다.