📌 스프링 Validation 기초 - 3편: @Valid와 BindingResult로 입력값 검증하기

📅 2025-04-23

📝 학습 내용

1️⃣ Validation이란? 왜 필요한가?

• Validation(검증)은 클라이언트로부터 전달받은 데이터가 유효한지 확인하는 과정입니다.

단순한 입력 체크를 넘어, 서비스의 데이터 무결성과 보안을 지키기 위한 첫 번째 방어선입니다.

💡 예시

• 회원가입 시 필수 항목 누락 방지
• 비밀번호 최소 길이 제한
• 숫자 범위 검증
• 악의적 입력(Injection) 사전 차단

---

2️⃣ 스프링 Validation 방식

• 스프링은 JSR-380(Bean Validation 2.0) 표준 기반.
• 대표 구현체: Hibernate Validator
• DTO에 어노테이션만 추가하면 자동으로 검증 가능.

---

3️⃣ 환경 설정 (Maven 의존성 추가)

<!-- Validation API -->
<dependency>
    <groupId>jakarta.validation</groupId>
    <artifactId>jakarta.validation-api</artifactId>
    <version>3.0.2</version>
</dependency>

<!-- Hibernate Validator -->
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>7.0.1.Final</version>
</dependency>

<!-- Expression Language (필요시) -->
<dependency>
    <groupId>org.glassfish</groupId>
    <artifactId>jakarta.el</artifactId>
    <version>3.0.3</version>
</dependency>

✅ Note

스프링 부트를 사용한다면 hibernate-validator가 기본 포함되어 있어 별도 설정이 필요 없다.

---

4️⃣ @Valid vs @Validated

어노테이션	특징	사용처
@Valid	JSR-380 표준, 단일 검증	일반적인 검증
@Validated	스프링 전용, 그룹 검증 지원	복잡한 검증 로직 필요 시

---

5️⃣ DTO 클래스에 검증 어노테이션 적용

import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;

public class PersonDto {
    @NotNull(message = "이름은 필수 입력값입니다.")
    private String name;

    @NotNull(message = "나이를 입력해 주세요.")
    private Integer age;

    @Size(min = 2, max = 20, message = "주소는 2자 이상 20자 이하로 입력하세요.")
    private String addr;

    // Getter, Setter, 생성자 생략
}

---

6️⃣ 컨트롤러에서 검증 처리

@PostMapping("/validate")
public String validateTest(@Valid PersonDto dto, BindingResult result, Model model) {
    if (result.hasErrors()) {
        // 검증 실패 시 에러 목록 전달
        model.addAttribute("errors", result.getAllErrors());
        return "param/errorPage";
    }
    // 검증 성공 시
    return "param/successPage";
}

💡 BindingResult는 반드시 @Valid 바로 뒤에 위치해야 검증 결과를 받을 수 있습니다!

---

7️⃣

에러 메시지 커스터마이징

• resources/messages.properties 파일 생성

NotNull.personDto.name=이름을 입력해 주세요.
Size.personDto.addr=주소는 {min}자 이상 {max}자 이하로 입력해야 합니다.

💡 TIP 스프링 설정에서 메시지 소스를 등록하면 다국어 처리도 가능!

---

🔥 요약

• Validation은 서비스의 안전망!
• @Valid + BindingResult 조합으로 유연한 검증 처리.
• 복잡한 검증이 필요하다면 @Validated + 그룹 기능 활용.
• 사용자 친화적인 에러 메시지 제공은 기본.
• 실무에서는 커스텀 Validator도 적극 활용 필요.

---

🔗 참고 자료

• Hibernate Validator 공식 문서
• Spring Validation Guide

---

느낀 점

이번 학습을 통해 입력값 검증이 단순한 옵션이 아니라 필수라는 걸 다시 느꼈다.

특히 BindingResult를 활용하면 디버깅과 사용자 피드백 처리가 훨씬 수월해진다.

앞으로는 검증 로직을 표준화하여, 서비스 안정성을 높이는 데 집중할 계획이다.