Spring Boot + JPA 프로젝트에서 주문서 목록 조회 시 항목이 2배, 3배로 뻥튀기되는 버그를 만났다. DB 데이터는 정상인데 API 응답에서만 중복이 발생하는, 디버깅하기 까다로운 유형의 버그였다.

원인은 하나의 JPQL 쿼리에서 두 개의 @OneToMany 컬렉션을 동시에 JOIN FETCH한 것이었다. 이 글에서는 문제의 원인, 왜 DISTINCT로도 해결되지 않는지, 그리고 올바른 해결법을 정리한다.

증상: “데이터는 맞는데 화면이 이상해요”

SaaS 구독 관리 시스템에서 4월 주문서를 생성한 후, 목록에서 이상한 점이 발견됐다.

주문서 목록 — 상품명이 2번씩 표시되고, 금액이 2배

모든 고객의 상품명이 2번씩 반복되고, 금액도 정확히 2배였다. 상세 화면을 열어보면 더 명확했다:

주문서 상세 — 같은 상품이 2개씩 표시됨

  • 프리미엄 구독 ₩52,000 × 2개
  • 클라우드 스토리지 ₩25,000 × 2개
  • 청구 금액: ₩146,000 (뻥튀기된 금액)

그런데 흥미로운 단서가 하나 있었다:

결제 링크 금액은 정상 (₩69,000)

결제 링크 금액은 ₩69,000으로 정상이었다. 이건 DB에 저장된 실제 값이다.

디버깅 과정

1단계: DB 데이터 확인

DB를 직접 조회했다.

SELECT oli.id, oli.product_name, oli.price
FROM order_line_item oli
WHERE oli.order_id = 369;

DB 조회 결과

2개뿐이다. DB에는 중복이 없다.

2단계: 프론트엔드 확인

React 컴포넌트를 확인했다. 단순히 order.lineItems.map()으로 렌더링하고 있었다. 프론트엔드 문제가 아니다.

3단계: API 응답이 문제

DB → API 응답 사이에서 중복이 발생한다는 뜻이다. JPA 쿼리를 확인했다.

원인: 두 컬렉션의 Cartesian Product

문제의 쿼리:

@Query("SELECT i FROM Invoice i " +
       "LEFT JOIN FETCH i.lineItems " +        // @OneToMany List
       "LEFT JOIN FETCH i.appliedDiscounts " +  // @OneToMany Set
       "JOIN FETCH i.studentProfile sp " +
       "JOIN FETCH sp.user u " +
       "WHERE i.campus.id = :campusId " +
       "AND i.billingYear = :year AND i.billingMonth = :month " +
       "ORDER BY u.name")
List<Invoice> findAllByCampusAndMonth(...);

lineItems(List)와 appliedDiscounts(Set)를 동시에 JOIN FETCH하고 있다.

SQL 실행 결과

이 JPQL이 실제로 생성하는 SQL을 보면:

SELECT o.*, oli.*, oad.*
FROM orders o
LEFT JOIN order_line_item oli ON oli.order_id = o.id
LEFT JOIN order_applied_discount oad ON oad.order_id = o.id
WHERE ...

Order 369에 lineItem 2개, appliedDiscount 2개가 있으면:

Cartesian Product SQL 결과

2 × 2 = 4행. 이것이 cartesian product다.

Hibernate의 컬렉션 처리 방식

Hibernate는 이 4행을 엔티티로 변환할 때:

  • Set (appliedDiscounts): equals/hashCode 기반으로 자동 중복 제거 → 2개 (정상)
  • List (lineItems): bag semantics — 중복 제거하지 않음 → 4개 (oli.id 385, 385, 386, 386)

List는 순서가 있는 컬렉션이고, Hibernate는 SQL 결과의 각 행을 List에 그대로 추가한다. 같은 엔티티가 여러 행에 걸쳐 나타나면, 같은 객체가 List에 여러 번 들어간다.

DISTINCT로는 해결되지 않는다

첫 번째 시도로 SELECT DISTINCT를 추가해봤다:

@Query("SELECT DISTINCT o FROM Order o " +
       "LEFT JOIN FETCH o.lineItems " +
       "LEFT JOIN FETCH o.appliedDiscounts " + ...)

효과 없음. 이유:

Hibernate 6에서 JPQL DISTINCT는 root entity(Order)의 중복을 제거한다. 결과 리스트에 같은 Order 객체가 여러 번 나타나는 것을 방지하는 것이다.

하지만 Order 내부의 lineItems List 중복은 건드리지 않는다. Order 369는 결과에 1번만 나타나지만, 그 Order의 lineItems는 이미 4개가 채워진 상태다.

해결: 컬렉션 FETCH 분리

근본 원칙: 하나의 쿼리에서 여러 @OneToMany 컬렉션을 JOIN FETCH하지 않는다.

적용한 해결법: @BatchSize

// Order.java
@OneToMany(mappedBy = "order", cascade = CascadeType.ALL, orphanRemoval = true)
@BatchSize(size = 50)  // 별도 IN 쿼리로 배치 로딩
private Set<OrderAppliedDiscount> appliedDiscounts = new LinkedHashSet<>();

// OrderRepository.java — appliedDiscounts JOIN FETCH 제거
@Query("SELECT DISTINCT o FROM Order o " +
       "LEFT JOIN FETCH o.lineItems " +
       // LEFT JOIN FETCH o.appliedDiscounts — 제거!
       "JOIN FETCH o.customer c " +
       "WHERE o.billingYear = :year AND o.billingMonth = :month ...")
List<Order> findAllByMonth(...);

이제 실행 흐름:

  1. 쿼리 1: Order + lineItems JOIN FETCH → lineItem 수만큼 행 (중복 없음)
  2. 쿼리 2 (자동): SELECT * FROM order_applied_discount WHERE order_id IN (?, ?, ..., ?) → 최대 50개씩 배치

쿼리가 1개에서 2개로 늘었지만, cartesian product가 사라져 정확한 데이터가 반환된다.

대안들

대안 비교

핵심 정리

하나의 쿼리에서 여러 @OneToMany 컬렉션을 JOIN FETCH하면
SQL Cartesian Product → List(bag) 컬렉션 중복 → 데이터 뻥튀기
  • DB는 정상, API만 이상 → JPA 쿼리의 컬렉션 FETCH 확인
  • DISTINCT는 root entity 중복만 제거, List 내부 중복은 해결 못 함
  • Set은 자동 중복 제거, List(bag)는 안 됨
  • 해결: 한 쿼리에 하나의 컬렉션만 FETCH + 나머지는 @BatchSize

참고