📌 스프링 Validation 심화 - 4편: 커스텀 Validator와 고급 검증 전략

📅 2025-04-23

📝 학습 내용

1️⃣ 커스텀 Validator 구현하기

스프링에서 제공하는 기본 검증 어노테이션(@NotNull, @Size 등)만으로는

복잡한 비즈니스 검증 로직을 처리하기 어려운 경우가 많습니다.

💡 예시

• 사용자 ID가 특정 패턴을 따라야 한다.
• DB에 존재하지 않는 값인지 확인해야 한다.
• 날짜 범위 검증 등.

이럴 때 커스텀 Validator를 통해 직접 검증 로직을 정의할 수 있습니다.

---

✅ 사용자 정의 어노테이션 생성

@Documented
@Constraint(validatedBy = UsernameValidator.class)
@Target({ ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidUsername {
    String message() default "유효하지 않은 사용자 이름입니다.";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

---

✅ 검증 로직 클래스 구현

public class UsernameValidator implements ConstraintValidator<ValidUsername, String> {
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        return value != null && value.matches("^[a-zA-Z0-9]{5,12}$");
    }
}

---

2️⃣ Validation 그룹(Group) 기능

검증 상황에 따라 다른 규칙을 적용할 수 있는 기능입니다.

예시)

• 회원가입(Create) 시 비밀번호 필수
• 회원정보 수정(Update) 시 비밀번호는 선택적

public interface CreateGroup {}
public interface UpdateGroup {}

public class PersonDto {
    @NotNull(groups = CreateGroup.class)
    private String name;
}

@PostMapping("/create")
public String create(@Validated(CreateGroup.class) PersonDto dto, BindingResult result) { ... }

---

3️⃣ 글로벌 Validator 등록

공통 검증 로직을 모든 컨트롤러에 자동 적용할 때 사용합니다.

(예: 모든 요청에 대해 특정 토큰 검증 등)

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public Validator getValidator() {
        return new LocalValidatorFactoryBean();
    }
}

💡 글로벌 Validator는 반복되는 검증 로직을 중앙 집중화할 때 유용합니다!

---

4️⃣ 에러 메시지 관리 & 다국어 처리

• resources/messages.properties 파일에 에러 메시지 작성.
• 다국어 처리는 사용자의 Locale에 따라 자동 적용.

ValidUsername=아이디는 영문과 숫자 조합 5~12자리여야 합니다.

스프링 설정 예시:

@Bean
public MessageSource messageSource() {
    ResourceBundleMessageSource source = new ResourceBundleMessageSource();
    source.setBasename("messages");
    return source;
}

---

🔥 요약

• 기본 검증으로 부족할 때는 커스텀 Validator 활용.
• 그룹 기능으로 상황별 검증 분기 처리.
• 글로벌 Validator로 공통 검증 표준화.
• 에러 메시지는 관리하기 쉽게 구성 + 다국어 지원 고려.
• ⚡ 검증 로직은 비즈니스 로직과 분리해서 유지보수성을 높이자!

---

🔗 참고 자료

• Spring Validation 공식 문서
• Hibernate Validator User Guide

---

느낀 점

이번 심화 학습을 통해 단순한 입력값 체크를 넘어,

서비스 전반에 적용할 수 있는 검증 전략을 고민하게 되었다.

특히 커스텀 Validator와 그룹 기능은 실무에서 복잡한 검증 요구사항을 깔끔하게 해결해줄 강력한 도구였다.