🛠️ 부록 : 여차저차 JPA 적응기

개요

JPA를 잘 모르고 쓰다보니 이번 사이드에서 꽤나 많은 곤욕을 치렀다. 물론 잘 안된다 싶을 때 검색하면 해결책이 다 나왔지만, 어려운 케이스는 고민을 많이 했다. 이번 기회에 사소한 문제부터 정리해서 틈틈이 확인해보려 한다.

트러블 슈팅 정리

이슈 발생 : detached entity passed to persist

1️⃣ 문제

회원이 가진 쿠폰 이력(unused_coupon_book)을 회원이 직접 관리해야 한다고 생각해 Cascade ALL로 설정했더니 문제가 발생했다.

@Entity
@Table(name = "member")
class MemberEntity(
    @ManyToMany(
        targetEntity = CouponEntity::class,
        cascade = [CascadeType.ALL],
    )
    @JoinTable(
        name = "unused_coupon_book",
        joinColumns = [JoinColumn(name = "member_id")],
        inverseJoinColumns = [JoinColumn(name = "coupon_id")],
    )
    var unusedCoupons: List<CouponEntity>,   
}

지나가기 전에 Cascade를 정리해봤다. Cascade 는 엔티티 상태에 따라 어떻게 동작할지 결정하는 설정값이다.

• PERSIST : 엔티티를 영속화 할 때 연관된 엔티티도 영속화한다.
• MERGE : 엔티티를 병합할 때 연관된 엔티티도 병합한다.
• REMOVE : 엔티티 삭제할 때 연관된 엔티티도 함께 삭제한다.
• REFRESH : 엔티티 갱신할 때 연관된 엔티티도 함께 갱신한다.

2️⃣ 원인

Cascade는 unused_coupon_book 을 타겟으로 하지 않고 coupon entity을 타겟으로 한다.

참고 자료 : JPA Hibernate many-to-many cascading

직접 테스트했을 때 CascadeType.Persist 설정과 함께 member entity + coupon entity 를 생성하는 경우 coupon entity 가 저장됐다. CascadeType.Remove 설정은 member entity가 삭제되면 coupon entity가 삭제되어야 하는게 그렇지 않았다…? 테스트 방법이 잘못됐나 해서 entity manager로 remove 메서드를 실행해도 동작하지 않았다.

3.X 버전으로 넘어오면서 동작이 변경됐나 생각이 든다… 관련 문서는 확인하기 어렵다.

3️⃣ 해결

영속 상태에서 분리된(deteched) 엔티티를 persist() 메서드로 영속화할 때 발생하며 다음 중 하나를 선택하면 된다.

1. 연관 관계 매핑을 통해 CouponEntity 가 조회됨.
2. 조회된 CouponEntity가 준영속 상태가 됨.

회원은 존재하는 쿠폰을 찾아 연관 관계를 맺는다. 회원이 없어지면 연관된 쿠폰을 없어지면 안된다. 그래서 coupon entity 와 영속 상태를 유지 하며 수정될 이유도 없다.

4️⃣ 정리

🛠️ 정리중

이슈 발생 : could not initialize proxy - no Session

1️⃣ 문제

세션이 없는 상태로 lazy 데이터에 접근하게 되면 텅 비어 있어서 발생하는 문제다. JPA에서 세션은 영속성 컨텍스트를 생성하고 관리하는 객체이며 EntityManger가 세션 역할을 수행한다. EntityManger를 통해 트랜잭션을 실행하고 커밋하며 한정적인 세션을 열어 지연 로딩이 가능하게 한다. 즉, 지연 로딩을 사용하려면 다음처럼 트랜잭션 내부에서 접근해야 한다.

fun find() {
  em.transaction.begin()

  val member = repoository.find() // 데이터 조회 영역
  println(member.unusedCoupons.size) // 데이터 접근 영역
  
  em.transaction.commit()
}

2️⃣ 원인

비즈니스 로직에 트랜잭션을 관리하다 보니 하위 레이어에서 JPA 관련 테스트를 수행 할 수 없었다. 테스트를 진행하려면 하위 레이어도 트랜잭션으로 새롭게 묶거나 즉시 로딩이 되게 설정해야 한다.

3️⃣ 해결

이 문제를 해결하려면 조회하는 영역과 lazy 데이터를 접근하는 영역을 같은 세션(트랜잭션)으로 포함시키거나 즉시 로딩이 되게 만드는 방법이다.

• 트랜잭션 단위로 묶는다.
• 즉시 로딩이 되게 한다.

주의할 점은 테스트를 위한 코드가 생성된 점인데, 즉시 로딩을 하는 경우 테스트로 인해 프로덕트 성능이 변화한다는 문제점이 있었고, 트랜잭션은 이미 트랜잭션이 실행되면 기존 트랜잭션을 유지하기 때문에 성능에 영향을 주지 않았다. 또한 즉시 로딩 할 만큼 해당 필드가 항상 필요하지 않아서 트랜잭션 영역을 덮어쓰도록 수정했다.

4️⃣ 정리

테스트 할 때 JPA를 실행하기 위해 대부분의 레이어에 트랜잭션을 붙여야 하는 대참사가 발생할 수 있다. 성능에는 차이가 없지만 테스트 관리가 어려워질 수 있다. 적절하게 잘 고민해서 선택하도록 하자.