4.6 KiB
4.6 KiB
PRD: 라이브 예약 LazyInitializationException 수정
1. Overview
spring.jpa.open-in-view=false 환경에서 라이브 예약 생성 시 LiveRoom.reservations lazy 컬렉션 접근으로 발생하는 LazyInitializationException을 서비스 트랜잭션 경계로 방지한다.
2. Problem
LiveReservationService.makeReservation()에는 쓰기 트랜잭션 경계가 없다.liveRoomRepository.findByIdOrNull()호출이 끝난 뒤 반환된LiveRoom은 영속성 컨텍스트에서 분리된다.reservation.room = room은LiveReservation.room의 사용자 정의 setter를 호출하고, setter는room.reservations.add(this)로 lazy 컬렉션을 초기화한다.- OSIV가 비활성화된 상태에서는 컬렉션을 초기화할 Session이 없어
org.hibernate.LazyInitializationException: failed to lazily initialize a collection of role: kr.co.vividnext.sodalive.live.room.LiveRoom.reservations, could not initialize proxy - no Session이 발생한다. - 유료 예약에서는
CanPaymentService.spendCan()만 자체 트랜잭션으로 먼저 커밋될 수 있어, 이후 예약 저장이 실패하면 결제와 예약 상태가 분리될 위험도 있다.
3. Goals
- OSIV off 환경에서도 라이브 예약 생성이 lazy 초기화 예외 없이 완료된다.
makeReservation()의 라이브방 조회, 결제, 예약 저장을 하나의 트랜잭션 경계에서 처리한다.- 트랜잭션 없는 테스트 메서드에서 실제 Spring 서비스 프록시를 호출해 기존 오류를 재현하고 회귀를 방지한다.
- 기존 라이브 예약 API URL, 요청 및 응답 스키마를 변경하지 않는다.
4. Non-Goals
spring.jpa.open-in-view를 활성화하지 않는다.LiveRoom.reservations를 eager fetch로 변경하지 않는다.LiveReservation.room의 양방향 연관관계 setter를 재설계하지 않는다.- 예약 중복 방지나 동시성 정책을 새로 도입하지 않는다.
- 결제 및 예약 정책, 응답 문구와 날짜 포맷을 변경하지 않는다.
5. Target Users
- 사용자: 무료 또는 유료 라이브를 오류 없이 예약하려는 회원
- 운영자: OSIV off 정책을 유지하면서 결제와 예약 저장의 일관성을 보장하려는 운영 담당자
6. User Stories
- 사용자는 예약 가능한 라이브를 선택했을 때 서버의 lazy 초기화 오류 없이 예약을 완료할 수 있어야 한다.
- 유료 라이브 예약은 결제와 예약 저장 중 하나가 실패하면 전체 작업이 함께 롤백되어야 한다.
- 운영자는 OSIV와 엔티티 fetch 전략을 변경하지 않고 서비스 트랜잭션 경계로 오류를 방지할 수 있어야 한다.
7. Core Features
Feature A. 라이브 예약 생성 트랜잭션 보강
Requirements
LiveReservationService.makeReservation()에 쓰기@Transactional을 적용한다.liveRoomRepository.findByIdOrNull()로 조회한LiveRoom은 예약 연관관계 설정과 저장이 끝날 때까지 managed 상태를 유지한다.CanPaymentService.spendCan()의 기본REQUIRED전파 속성은 외부 예약 트랜잭션에 참여한다.- 기존 비밀번호 검증, 중복 예약 검증, 보유 캔 검증, 결제, 예약 응답 생성 순서를 유지한다.
Edge Cases
- 가격이 0인 무료 라이브도
LiveRoom.reservationslazy 컬렉션 초기화 예외 없이 예약된다. - 가격이 0보다 큰 라이브는 결제와 예약 저장이 같은 트랜잭션에 참여한다.
- 존재하지 않는 라이브방이나 회원, 잘못된 비밀번호, 중복 예약, 캔 부족에 대한 기존 예외 동작을 유지한다.
8. Technical Constraints
- Kotlin, Java 17, Spring Boot 2.7.14, Spring Data JPA, JUnit 5, Gradle Wrapper를 사용한다.
- 서비스 쓰기 메서드 단위로
@Transactional경계를 명확히 한다. - 테스트 클래스 자체 트랜잭션은 비활성화해 서비스 프록시의 트랜잭션 경계만 검증한다.
- 실제 JPA 엔티티를 저장하고 영속성 컨텍스트를 비운 뒤 서비스를 호출하는 통합 테스트로 검증한다.
- 변경 범위는
LiveReservationService.makeReservation(), 해당 회귀 테스트, PRD와 Plan/TASK 문서로 제한한다.
9. Metrics
- 수정 전 회귀 테스트가
LazyInitializationException으로 실패한다. - 수정 후 같은 회귀 테스트가 통과하고 예약 레코드가 저장된다.
- 관련 테스트,
ktlintCheck,tasks --all,git diff --check가 통과한다.
10. Open Questions
- 없음. 승인된 권장안인 서비스 쓰기 트랜잭션 적용과 OSIV off 통합 회귀 테스트로 범위를 확정한다.