📌 Spring MVC 유효성 검사(@Valid, BindingResult) 실습

📅 날짜

2025-04-24

---

📝 학습 내용

1️⃣ 유효성 검사 개요

• 유효성 검사(Validation)란? 사용자의 입력값이 적절한지 서버에서 검증하는 과정.
  
• @Valid : DTO에 선언된 검증 애노테이션을 기반으로 자동 검증 수행.
• BindingResult : 검증 결과를 받아 에러 처리 및 로직 분기.

✔️ 검증 흐름 요약

클라이언트 입력값 → Controller(@Valid) → BindingResult로 에러 확인 → View로 피드백

---

2️⃣ MemoDto 설정

@Data
@NoArgsConstructor
@AllArgsConstructor
public class MemoDto {
    @Min(value = 10, message = "ID는 10 이상이어야 합니다.")
    @Max(value = 65535, message = "ID의 최대 숫자는 65535이하여야 합니다.")
    @NotNull(message = "ID는 필수 입력값입니다.")
    private Integer id;

    @NotBlank(message = "메모를 입력하세요")
    private String text;

    @NotBlank(message = "작성자를 입력하세요")
    @Email(message = "올바른 이메일 형식을 입력해주세요")
    private String writer;

    @DateTimeFormat(pattern = "yyyy-MM-dd'T'HH:mm")
    @NotNull(message = "날짜정보를 선택해주세요")
    private LocalDateTime createAt;
}

---

3️⃣ MemoController 설정

@PostMapping("/add")
public void add_post(@Valid MemoDto dto, BindingResult bindingResult) {
    log.info("POST /memo/add..." + dto);

    if(bindingResult.hasErrors()) {
        for(FieldError error : bindingResult.getFieldErrors()) {
            log.info("Error Field: " + error.getField() + " Error Msg: " + error.getDefaultMessage());
        }
    }
}

---

4️⃣ add.jsp (메모 작성 폼)

<form action="${pageContext.request.contextPath}/memo/add" method="post">
    <div>
        <label>id : </label><input name="id" />
    </div>
    <div>
        <label>text : </label><textarea name="text"></textarea>
    </div>
    <div>
        <label>writer : </label><input name="writer" />
    </div>
    <div>
        <label>createAt : </label><input type="datetime-local" name="createAt" />
    </div>
    <div>
        <input type="submit" value="메모쓰기" />
    </div>
</form>

---

5️⃣ servlet-context.xml 설정

<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean"/>
<annotation-driven validator="validator"/>

---

6️⃣ pom.xml 의존성

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.2.5.Final</version>
</dependency>
<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>2.0.1.Final</version>
</dependency>
<dependency>
    <groupId>javax.el</groupId>
    <artifactId>javax.el-api</artifactId>
    <version>3.0.0</version>
</dependency>
<dependency>
    <groupId>org.glassfish.web</groupId>
    <artifactId>javax.el</artifactId>
    <version>2.2.6</version>
</dependency>

---

⚠️ 의존성 설정 시 발생한 문제 & 해결 과정

💥 문제 발생

초기에 hibernate-validator의 최신 버전인 8.x를 추가했더니, 서버 실행 시 아래 에러 발생:

javax.validation.NoProviderFoundException:
Unable to create a Configuration, because no Bean Validation provider could be found.

• 원인 : Spring 5.x와 Hibernate Validator 8.x 버전 간의 호환성 문제
• 레거시(Spring Legacy, STS3) 환경에서는 검증 라이브러리도 버전에 맞춰야 함.

---

✅ 해결 방법

• Hibernate Validator를 6.2.5.Final로 버전 다운그레이드
• Maven 업데이트 후 서버 재시작 ➜ 정상 작동!

Tip 🔧

항상 사용하는 프레임워크(Spring 등) 버전에 맞는 라이브러리 버전을 확인하자!

최신 버전이 항상 최선은 아니다.

---

🔹 실행 결과

Error Field: text Error Msg: 메모를 입력하세요
Error Field: createAt Error Msg: 날짜정보를 선택해주세요
Error Field: id Error Msg: ID는 필수 입력값입니다.
Error Field: writer Error Msg: 작성자를 입력하세요

---

🔥 정리

• @Valid와 BindingResult 조합으로 간편하게 서버 검증 구현.
• DTO 중심의 검증 설계로 코드 간결화.
• Validator 설정과 의존성 버전이 핵심 포인트.
• 실무에서는 에러 메시지를 Model에 담아 View로 전달 ➜ 사용자 피드백 강화.

---

🔗 참고 자료

• Spring 공식 문서 - Validation
• Hibernate Validator

---