JPA에서 Enum 컬럼 제대로 저장하기

오늘은 Entity를 생성하며 겪은 이슈인

Spring Boot JPA에서 Enum 컬럼 매핑할 때 발생하는 문제와 해결법에 대해 정리해보았다.

 

 

⛏️ 처음 코드에서 에러 발생

@Column(name = "status", nullable = false)
private OrderStatusEnum status = OrderStatusEnum.PENDING;

 

• Hibernate가 Enum을 어떻게 변환해야 할지 몰라 IllegalArgumentException이 발생했다.
• 기본적으로 Hibernate가 ORDINAL(숫자)로 저장하려해서 DB타입과 충돌한다.

 

 

⛏️ @Enumerated(EnumType.STRING) 추가 

 @Enumerated(EnumType.STRING)
    @Column(name = "status", nullable = false)
    private OrderStatusEnum status = OrderStatusEnum.PENDING;

•  EnumType.STRING 을 추가하면 Enum 값이 DB에 문자열로 저장될 수 있다.
• 하지만 특정 DB에서는 여전히 Enum을 제대로 인식하지 못 할 수 있고, 나 또한 해결하지 못했다.

 

⛏️ 최종 해결 (JdbcTypeCode 추가)

 @Enumerated(EnumType.STRING)
    @Column(name = "status", nullable = false)
    @JdbcTypeCode(SqlTypes.NAMED_ENUM)
    private OrderStatusEnum status = OrderStatusEnum.PENDING;

• @JdbcTypeCode(SqlTypes.NAMED_ENUM)을 추가하면 Hibernate가 Enum을 더 명확하게 인식하고, DB와 매핑할 수 있다. 
• 이렇게 하면 안정적으로 Enum을 저장할 수 있다!

 

작은 트러블슈팅이지만, 해당 이슈를 겪으면서 Hibernate가 Enum을 어떻게 처리하는지 조금 더 깊이 이해할 수 있었다. 

앞으로는 Enum type 매핑때문에 생기는 문제는 미리 예방할 수 있을 것 같다!