하이버네이트의 시간은 거꾸로 간다

간단 소개

스프링부트 업그레이드 후 하이버네이트 버전 변경으로 인해 발생한 DateTime 관련 버그를 분석하고 해결한 과정에 대한 기술 블로그.

AI Summary

사건의 발단 및 문제 정의
- 스프링부트 버전 업그레이드(3.x) 후 배포, 샛별 배송 시간대에 컬리버드 앱 로그인 불가 에러 발생
- 에러 로그 분석 결과, DB 조회 과정에서 DateTime 형식 문제 확인. 음수 나노초 값이 원인으로 추정
- DB 데이터 검토 결과, 음수 나노초 데이터는 없으나 배포 전후 나노초 값에 미묘한 차이 발견
원인 분석 및 해결
- 하이버네이트 버전 업그레이드(5.6.5 -> 6.5.5)로 인해 LocalTime을 DB에 저장하는 방식 변경 확인
- 구 버전은 나노초 무시, 신 버전은 나노초 반영. 이로 인해 배포 전후 나노초 유무 달라짐
- 조회 시 음수 나노초 발생 원인은 LocalTimeJavaType.wrap 메서드 내 ms 계산 로직 문제
- KST 타임존에서 epoch time 음수 도출, ms 값 계산 시 음수 발생
- 임시 해결책으로 LocalTime 객체 저장/조회 시 나노초 제거하는 Converter 적용