<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by 이한음 on Medium]]></title>
        <description><![CDATA[Stories by 이한음 on Medium]]></description>
        <link>https://medium.com/@ummdev03?source=rss-9e645e4c1b2e------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*rNabZYocA2AB6OfJ</url>
            <title>Stories by 이한음 on Medium</title>
            <link>https://medium.com/@ummdev03?source=rss-9e645e4c1b2e------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 03:44:11 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@ummdev03/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[SpringBoot3.2 이후 버전에서 @Valid가 동작하지 않을 때]]></title>
            <link>https://medium.com/@ummdev03/springboot3-2-%EC%9D%B4%ED%9B%84-%EB%B2%84%EC%A0%84%EC%97%90%EC%84%9C-valid%EA%B0%80-%EB%8F%99%EC%9E%91%ED%95%98%EC%A7%80-%EC%95%8A%EC%9D%84-%EB%95%8C-86969320cc0f?source=rss-9e645e4c1b2e------2</link>
            <guid isPermaLink="false">https://medium.com/p/86969320cc0f</guid>
            <category><![CDATA[validation]]></category>
            <category><![CDATA[디프만]]></category>
            <category><![CDATA[디프만-15기]]></category>
            <category><![CDATA[depromeet]]></category>
            <category><![CDATA[spring-boot]]></category>
            <dc:creator><![CDATA[이한음]]></dc:creator>
            <pubDate>Fri, 13 Sep 2024 08:01:05 GMT</pubDate>
            <atom:updated>2024-09-13T14:03:13.403Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*iEMs9OWcOkofpdiYSXiT6w.png" /></figure><p>안녕하세요. 디프만 15기 3팀 Server Engineer 이한음입니다.<br>모링 서비스를 개발하는 과정에서 여러 기술적 이슈를 겪었고, 그 중 하나로 @Valid 어노테이션이 제대로 동작하지 않는 문제를 해결했던 경험을 공유하고자 합니다.</p><h3>유효성 검증 기본 원리</h3><h4>@Valid 어노테이션이란?</h4><p>@Valid 어노테이션은 Java에서 제공하는 유효성 검증 기능으로, 주로 객체의 필드 값이 유효한지 확인할 때 사용됩니다. @Valid는 스프링에서 AOP 기반으로 동작하는 @Validated와는 다르게, RequestMappingHandlerAdapter가 유효성 검증을 위임하여 처리되고, 이를 통해 Controller 레벨에서 @RequestParam이나 @RequestBody 등 필드 유효성을 쉽게 검증할 수 있습니다.</p><h4><strong>Validation 의존성 추가</strong></h4><pre>implementation(&quot;org.springframework.boot:spring-boot-starter-validation&quot;)</pre><p>SpringBoot2.3 버전부터는 spring-boot-starter-web 의존성 내부에 있던 validation이 별도의 모듈로 분리되어 위 의존성을 추가해주어야 합니다. @Valid 어노테이션이 동작하지 않는다면 의존성을 추가했는지 먼저 확인해야합니다.</p><h4>SpringBoot3.2 이전 버전에서 @Valid 어노테이션이 동작하는 과정</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XrMLnp8QILDqVXHifan63g.png" /></figure><p>스프링에서 Dispatcher Servlet은 RequestMappingHandlerAdapter를 통해 클라이언트로부터 들어오는 요청을 처리합니다. 유효성 검증을 위한 Validator를 미리 등록해두고, 요청이 들어왔을 때 ArgumentResolver를 호출해서 @RequestParam, @RequestBody, @ModelAttribute 등 들어오는 모든 필드를 검증합니다.</p><p>중요한 점은 @RequestParam, @RequestBody에 대한 검증을 SpringBoot3.2 이전 버전에서는 ArgumentResolver 하나가 모두 위임 받는다는 것입니다. 따라서 @NotNull, @Size 와 같은 Constraint 어노테이션을 parameter 혹은 body에 붙여주기만 하면 필드 유효성 검증이 이루어졌습니다.</p><h3>문제 상황</h3><h4>SpringBoot3.3 버전에서 @RequestBody에 대한 @Vaild 유효성 검증이 이루어지지 않음</h4><pre>@PostMapping(&quot;/members&quot;)<br>public ResponseEntity&lt;MeetingMemberPersistResponse&gt; createMeetingMember(<br> @UserId Long userId,<br> @RequestParam(&quot;code&quot;) String code,<br> @Valid @RequestBody MeetingMemberPersistRequest request<br>) {<br> MeetingMemberPersistResponse response = meetingMemberService.registerMeetingMember(userId, code, request);<br> return ResponseEntity.status(CREATED).body(response);<br>}ㅓ</pre><p>앞에서 언급한 원리대로라면 ArgumentResolver가 @RequestBody에 대한 유효성 검증을 수행해야 합니다. 하지만 @Valid 어노테이션을 사용했음에도 불구하고 필드 유효성 검증이 이루어지지 않는 상황이 벌어지게 되었습니다. 따라서 이에 대한 원인을 유효성 검사가 ArgumentResolver가 아닌 다른 컴포넌트에 의해 처리되었을 가능성을 예상해볼 수 있습니다.</p><h3>새로운 유효성 검증 과정</h3><h4>SpringBoot3.2 버전부터 추가된 HandlerMethodValidationException 분석하기</h4><pre>@GetMapping<br>private ResponseEntity&lt;String&gt; get(<br> @Valid @RequestParam(name = &quot;param&quot;)<br> @Pattern(regexp = &quot;^[a-zA-Z0-9]{6}$&quot;,message = &quot;The request parameter must be 6 characters long and consist of alphanumeric characters.&quot;) String param<br><br>) {<br> return ResponseEntity.ok().build();<br>}</pre><p><a href="https://stackoverflow.com/questions/78142735/custom-error-messages-in-spring-rest-api-validation-problemdetails">stackOverflow의 이 글</a>을 보면 해당 글의 필자는 위 코드처럼 @RequestParam에 대한 유효성 검증을 수행하려고 합니다. SpringBoot3.2 이전 버전에서는 ArgumentResolver가 유효성 검증을 위임 받는 것이 정상인데, 필자는 해당 유효성 검증에서 HandlerMethodValidationException이라는 예외가 발생했다고 합니다.</p><h4>MethodValidator의 유효성 검증</h4><pre>ResponseStatusException that is also MethodValidationResult. <br>Raised by HandlerMethodValidator in case of method validation errors on a web controller method.</pre><p>해당 예외에 대한 설명을 보면 HandlerMethodValidationException은 Controller 메서드에 대한 유효성 검사 실패 시 발생하고 (Handler)MethodValidator에 의해 발현됩니다. ArgumentResolver가 아닌 MethodValidator에 의해 발현된다는 것이 중요한 포인트 입니다. <a href="https://github.com/spring-projects/spring-framework/blob/main/spring-web/src/main/java/org/springframework/web/method/annotation/HandlerMethodValidationException.java">자세히 보려면 여기를 클릭</a>.</p><h4>@RequestBody에 대한 유효성 검증이 되지 않았던 이유</h4><pre>public HandlerMethodValidationException(MethodValidationResult validationResult) {<br> this(validationResult,<br>   param -&gt; param.hasParameterAnnotation(ModelAttribute.class),<br>   param -&gt; param.hasParameterAnnotation(RequestParam.class));<br>}</pre><p>HandlerMethodValidationException의 생성자를 보면 @ModelAttribute와 @RequestParam에 대한 유효성 검증 처리만을 전달하고 있습니다. 반면, @RequestBody나 @PathVariable 등에 대한 유효성 검증은 제외되어 있습니다.</p><h3>문제 해결하기</h3><pre>@PostMapping(&quot;/members&quot;)<br>public ResponseEntity&lt;MeetingMemberPersistResponse&gt; createMeetingMember(<br> @UserId Long userId,<br>  @RequestParam(&quot;code&quot;) String code,<br> @Valid @RequestBody MeetingMemberPersistRequest request<br>) {<br> MeetingMemberPersistResponse response = meetingMemberService.registerMeetingMember(userId, code, request);<br> return ResponseEntity.status(CREATED).body(response);<br>}</pre><p>문제의 코드를 다시 보겠습니다. 이 상황에서 HandlerMethodValidationException은 @RequestParam에 대한 검증만을 수행합니다. @Valid 어노테이션이 붙어 있어도, HandlerMethodValidationException은 @RequestBody에 대한 유효성 검사를 진행하지 않기 때문에, 유효성 검증이 제대로 이루어지지 않고 넘어갔다는 결론에 도달할 수 있습니다.</p><h4>@RequestBody에 대한 유효성을 검증하는 방법</h4><p>@RequestParam에 대한 유효성 검증은 정상적으로 이루어지고 있으니, 이제 @RequestBody에 대한 유효성 검증을 확인하기 위해 디버깅을 시도해 보겠습니다. 디버깅 과정에서 MethodArgumentNotValidException이 발생하면서, 아래와 같은 로그가 출력됩니다.</p><pre>MethodArgumentNotValidException: Validation failed for argument [1] in public<br>org.springframework.http.ResponseEntity&lt;org.depromeet.sambad.moring.meeting.<br>member.presentation.response.MeetingMemberPersistResponse&gt; org.depromeet.sambad<br>.moring.meeting.meeting.presentation.MeetingMemberController.<br>createMeetingMember(java.lang.Long,org.depromeet.sambad.moring.meeting.member.<br>presentation.request.MeetingMemberPersistRequest): // 생략...</pre><p>따라서 @RestControllerAdvice에 MethodArgumentNotValidException을 처리하는 예외 핸들링 로직을 추가하면, @RequestParam뿐만 아니라 @RequestBody에 대한 유효성 검사도 정상적으로 동작할 것입니다.</p><h4>최종 해결 코드</h4><pre>@RestControllerAdvice<br>public class GlobalExceptionHandler extends ResponseEntityExceptionHandler {<br><br> @Override<br> protected ResponseEntity&lt;Object&gt; handleHandlerMethodValidationException(HandlerMethodValidationException exception,<br>  HttpHeaders headers, HttpStatusCode status, WebRequest request) {<br><br>  String message = exception.getAllValidationResults().stream()<br>   .map(ParameterValidationResult::getResolvableErrors)<br>   .flatMap(List::stream)<br>   .map(MessageSourceResolvable::getDefaultMessage)<br>   .collect(Collectors.joining(&quot;, &quot;));<br>  ExceptionResponse response = ExceptionResponse.of(INVALID_INPUT.getStatus(), INVALID_INPUT.getCode(), message);<br><br>  return ResponseEntity.status(response.status()).body(response);<br> }<br><br> @Override<br> protected ResponseEntity&lt;Object&gt; handleMethodArgumentNotValid(MethodArgumentNotValidException exception,<br>  HttpHeaders headers, HttpStatusCode status, WebRequest request) {<br><br>  String message = exception.getFieldErrors().stream()<br>   .map(error -&gt; error.getField() + &quot;: &quot; + error.getDefaultMessage())<br>   .collect(Collectors.joining(&quot;, &quot;));<br>  ExceptionResponse response = ExceptionResponse.of(INVALID_INPUT.getStatus(), INVALID_INPUT.getCode(), message);<br><br>  return ResponseEntity.status(response.status()).body(response);<br> }<br>}</pre><p>앞서 언급한 원인에 따라, @RestControllerAdvice에 HandlerMethodValidationException과 MethodArgumentNotValidException을 처리하는 메서드를 추가해보겠습니다. 이제 @RequestParam에 대한 유효성 검사는 handleHandlerMethodValidationException 메서드에 의해 처리되며, @RequestBody에 대한 유효성 검증은 handleMethodArgumentNotValidException 메서드에 의해 처리될 것입니다.</p><pre>{<br>  &quot;code&quot;: &quot;INVALID_INPUT&quot;,<br>  &quot;message&quot;: &quot;name: size must be between 2 and 5&quot;<br>}</pre><p>API를 호출하고 Response Body를 보면 유효성 검증이 의도한대로 동작하는 것을 확인할 수 있습니다.</p><h3>정리 해보기</h3><ol><li>Spring Boot 3.2 이전 버전에서는 RequestMappingHandlerAdapter가 ArgumentResolver에게 유효성 검증을 위임했습니다.</li><li>그러나 Spring Boot 3.2 버전부터는 유효성 검증이 ArgumentResolver가 아니라 MethodValidator에 의해 수행됩니다.</li><li>MethodValidator의 HandlerMethodValidationException은 @RequestParam과 @ModelAttribute에 대한 유효성 검증만 처리합니다.</li><li>따라서 @RequestBody에 대한 유효성 검증을 보장하기 위해서는 @RestControllerAdvice에서 MethodArgumentNotValidException을 별도로 처리해야 합니다.</li></ol><h3>참고한 자료</h3><blockquote><a href="https://jforj.tistory.com/395">[SpringBoot] Spring Validation을 이용한 유효성 검증하기</a></blockquote><blockquote><a href="https://mangkyu.tistory.com/379">[SpringBoot] 스프링 부트3.2(SpringBoot3.2)에 추가된 유효성 검사 기능(MethodValidator) 파헤치기</a></blockquote><blockquote><a href="https://stackoverflow.com/questions/78142735/custom-error-messages-in-spring-rest-api-validation-problemdetails">Custom error messages in Spring Rest Api validation — ProblemDetails</a></blockquote><blockquote><a href="https://github.com/spring-projects/spring-framework/blob/main/spring-web/src/main/java/org/springframework/web/method/annotation/HandlerMethodValidationException.java">spring-framework/spring-web/src/main/java/org/springframework/web/method/annotation/HandlerMethodValidationException.java at main · spring-projects/spring-framework</a></blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=86969320cc0f" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>