JPA Cascade Type 정리

🔥 CascadeType 완벽 정리

📚 CascadeType 종류와 의미

1. CascadeType.PERSIST

 

 

java

@OneToMany(cascade = CascadeType.PERSIST)
private List<OrderItem> orderItems;

// 동작 예시
Order order = new Order();
order.addItem(new OrderItem("상품1"));  // 새로운 OrderItem
entityManager.persist(order);          // ✅ OrderItem도 자동 저장

의미: 부모 저장 시 자식도 자동 저장

2. CascadeType.MERGE

 

 

java

@OneToMany(cascade = CascadeType.MERGE)
private List<OrderItem> orderItems;

// 동작 예시
Order detachedOrder = getOrderFromSession();  // 영속성 컨텍스트에서 분리된 상태
detachedOrder.getItems().get(0).setPrice(1000);  // 자식 수정
entityManager.merge(detachedOrder);     // ✅ Order와 OrderItem 모두 업데이트

의미: 부모 병합 시 자식도 자동 병합

3. CascadeType.REMOVE

 

 

java

@OneToMany(cascade = CascadeType.REMOVE)
private List<OrderItem> orderItems;

// 동작 예시
Order order = entityManager.find(Order.class, 1L);
entityManager.remove(order);           // ✅ OrderItem들도 자동 삭제

의미: 부모 삭제 시 자식도 자동 삭제

4. CascadeType.REFRESH

 

 

java

@OneToMany(cascade = CascadeType.REFRESH)
private List<OrderItem> orderItems;

// 동작 예시
Order order = entityManager.find(Order.class, 1L);
// 다른 곳에서 DB 데이터가 변경됨
entityManager.refresh(order);          // ✅ Order와 OrderItem 모두 DB에서 재로딩

의미: 부모 새로고침 시 자식도 자동 새로고침

5. CascadeType.DETACH

 

 

java

@OneToMany(cascade = CascadeType.DETACH)
private List<OrderItem> orderItems;

// 동작 예시
Order order = entityManager.find(Order.class, 1L);
entityManager.detach(order);           // ✅ OrderItem들도 영속성 컨텍스트에서 분리

의미: 부모 분리 시 자식도 자동 분리

6. CascadeType.ALL

 

 

java

@OneToMany(cascade = CascadeType.ALL)
private List<OrderItem> orderItems;

// 위의 모든 cascade 동작을 포함
// = {PERSIST, MERGE, REMOVE, REFRESH, DETACH}

🎯 실무 사용 패턴

✅ 안전한 패턴들

1. 저장만 cascade (가장 일반적)

 

 

java

@OneToMany(cascade = CascadeType.PERSIST)
private List<Category> customCategories;

// 사용법
User user = new User();
user.addCategory(new Category("식비"));
userRepository.save(user);  // Category도 자동 저장

2. 저장 + 수정 cascade

 

 

java

@OneToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
private List<UserSetting> settings;

// 수정 시에도 자식이 함께 처리됨

3. 강한 결합 관계에서만 삭제 cascade

 

 

java

// ✅ 주문-주문상품 (생명주기가 같음)
@OneToMany(cascade = CascadeType.ALL, orphanRemoval = true)
private List<OrderItem> orderItems;

// ✅ 게시글-첨부파일
@OneToMany(cascade = CascadeType.ALL, orphanRemoval = true)  
private List<Attachment> attachments;

❌ 위험한 패턴들

1. 약한 결합에서 ALL 사용

 

 

java

// ❌ 위험: 사용자 삭제 시 모든 주문이 삭제됨
@OneToMany(cascade = CascadeType.ALL)
private List<Order> orders;

// ✅ 개선: 삭제는 별도 처리
@OneToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
private List<Order> orders;

2. 다대다 관계에서 CASCADE 사용

 

 

java

// ❌ 매우 위험
@ManyToMany(cascade = CascadeType.ALL)
private List<Role> roles;

// ✅ 다대다는 cascade 없이
@ManyToMany
private List<Role> roles;

🚨 실무 장애 사례

사례 1: 예상치 못한 삭제

 

 

java

// 관리자가 테스트 계정 삭제
User testUser = userRepository.findByEmail("test@test.com");
userRepository.delete(testUser);

// 😱 결과: CascadeType.ALL 때문에
// - 테스트 주문 100건 삭제
// - 관련 상품 리뷰 삭제  
// - 쿠폰 사용 이력 삭제

사례 2: 성능 문제

 

 

java

// 카테고리 하나 삭제
Category category = categoryRepository.findById(1L);
categoryRepository.delete(category);

// 😱 CascadeType.ALL로 인해
// - 10,000개 UserCategoryVisibility 조회
// - 각각 개별 DELETE 쿼리 실행
// - 30초 응답 지연 → 타임아웃

🛡️ 실무 가이드라인

1. Cascade 선택 기준

관계 유형권장 Cascade예시

강한 결합	ALL	주문↔주문상품, 게시글↔첨부파일
일반적 부모-자식	{PERSIST, MERGE}	사용자↔설정, 카테고리↔가시성
약한 결합	PERSIST 또는 없음	사용자↔주문, 카테고리↔상품
다대다	없음	사용자↔역할, 상품↔카테고리

2. orphanRemoval 사용 기준

 

 

java

// ✅ 부모에서 제거되면 자식도 삭제되어야 하는 경우
@OneToMany(cascade = {PERSIST, MERGE}, orphanRemoval = true)
private List<UserSetting> settings;

// ❌ 독립적으로 존재할 수 있는 경우  
@OneToMany(cascade = {PERSIST, MERGE}, orphanRemoval = false)
private List<Order> orders;

3. 실무 체크리스트

 

 

java

// ✅ 좋은 예시
@OneToMany(
    mappedBy = "user",
    cascade = {CascadeType.PERSIST, CascadeType.MERGE}, // 명시적 지정
    orphanRemoval = true,  // 필요한 경우만
    fetch = FetchType.LAZY // 지연 로딩
)
private List<UserSetting> settings = new ArrayList<>();

// ❌ 나쁜 예시  
@OneToMany(
    cascade = CascadeType.ALL,     // 너무 광범위
    fetch = FetchType.EAGER        // 성능 문제
)
private List<Order> orders;

🎯 핵심 원칙

1. 기본적으로 cascade 최소화
2. 삭제는 명시적으로 처리
3. 강한 결합 관계에만 ALL 사용
4. 다대다에는 cascade 사용 금지
5. 코드리뷰 시 cascade 근거 명시