JPA Enum 매핑 전략 최적화를 통한 데이터 무결성 보장 및 런타임 오류 방지

Context

JPA 기본 설정인 EnumType.ORDINAL 사용 시 Enum 순서 변경으로 인한 데이터 오염 발생 위험 상존. DB 레벨의 제약 조건 부재로 인해 잘못된 값이 저장되어도 런타임 시점까지 인지하지 못하는 구조적 한계 존재.

Technical Solution

• @Enumerated(STRING) 도입을 통한 상수명 저장 방식으로 순서 변경에 따른 데이터 매핑 오류 원천 차단
• Postgres Native Enum Type 적용으로 애플리케이션 외부에 데이터 유효성 검증 계층 추가
• JDBC connection URL에 stringtype=unspecified 옵션을 설정하여 varchar와 enum 타입 간의 Implicit Cast 문제 해결
• AttributeConverter를 구현하여 Java 식별자와 DB 저장 값(Stable Code)을 분리함으로써 상수명 변경 시의 Migration 비용 제거
• Lookup Table 구조는 런타임에 변경 가능한 비즈니스 속성(SLA, Label 등)이 포함된 경우로 한정하여 Join 오버헤드 최소화