[TroubleShooting] Cascade 옵션은 부모에게만

👀 현재 상황 및 배경 설명

• 현재 프로젝트에서는 N:M 관계(다대다 관계)가 적용된 Member와 Organization 엔티티 간의 연관관계를 설정하고 있다. 중간 테이블인 OrganizationMember 테이블이 두 엔티티를 연결해주며, 이를 통해 양방향 관계가 관리된다. 중간 테이블을 통해 Member는 여러 Organization에 속할 수 있으며, 반대로 각 Organization도 여러 Member와 연관될 수 있다. 현재는 Organization 엔티티에서만 양방향 관계를 설정하여 컬렉션 필드를 관리하고 있다.
• 또한, CascadeType 옵션을 통해 부모 엔티티 삭제 시 자식 엔티티도 자동으로 삭제되도록 구현했다. 그러나 중간 테이블인 OrganizationMember를 통해 양방향 관계를 관리할 때, CascadeType 옵션을 잘못 설정하면 의도치 않은 삭제가 발생할 수 있다.

 

▶ 구현 코드

🔽 Member 엔티티 클래스

@Entity
@Getter
@Builder
@NoArgsConstructor(access = AccessLevel.PROTECTED)
@AllArgsConstructor
public class Member {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    ...
}

🔽 Organization 엔티티 클래스

@Entity
@Getter
@Builder
@NoArgsConstructor(access = AccessLevel.PROTECTED)
@AllArgsConstructor
public class Organization {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    ...

    // 양방향 연관관계
    @Builder.Default
    @OneToMany(mappedBy = "organization", cascade = CascadeType.REMOVE, orphanRemoval = true)
    private List<OrganizationMember> organizationMembers = new ArrayList<>();
}

🔽 Organization과 Member의 중간 테이블을 관리하는 OrganizationMember 엔티티 클래스

@Entity
@Getter
@Builder
@NoArgsConstructor(access = AccessLevel.PROTECTED)
@AllArgsConstructor
public class OrganizationMember {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @ManyToOne(fetch = FetchType.LAZY, cascade = CascadeType.ALL)
    @JoinColumn(name = "organization_id")
    private Organization organization;

    @ManyToOne(fetch = FetchType.LAZY, cascade = CascadeType.ALL)
    @JoinColumn(name = "member_id")
    private Member member;

    ...
}

 

 

🚨 문제 상황

자식 엔티티인 OrganizationMember 엔티티에도 CascadeType.ALL이 설정되어 있어, 부모 엔티티인 Organization을 삭제할 때 예상하지 못하게 Member 엔티티까지 삭제되는 문제가 발생했다. 비즈니스 로직 상으로는 단체를 삭제했을 뿐인데, 해당 단체에 속해 있던 회원들까지 삭제되는 상황이 발생한 것이다.

 

 

✏️ 원인 분석

• Organization과 OrganizationMember는 부모-자식 관계고, OrganizationMember와 Member 역시 부모-자식 관계로 설정되어 있다. 따라서 Organization에서 OrganizationMember를 삭제할 때, OrganizationMember에 설정된 CascadeType 때문에 Member까지 삭제되는 문제가 발생했다. 이는 자식 엔티티에 cascade 옵션을 설정하면서, 부모-자식 간의 연관관계를 잘못 관리한 결과다.
• 또한, 부모-자식 관계와 연관관계의 주인에 대한 개념이 명확하지 않았던 점도 문제였다. 현재 연관관계의 주인은 OrganizationMember인데, 이를 부모-자식 관계로 혼동하여 CascadeType을 적용해야 한다고 잘못 판단한 것이 이번 오류의 원인 중 하나였다.

 

 

🔨 해결 방법

부모 엔티티에만 cascade 옵션을 적용하고, 자식 엔티티에는 cascade를 적용하지 않도록 수정한다. 자식 엔티티에는 부모 엔티티와의 관계만을 설정하고, CascadeType을 제거한다.

🔽 자식 엔티티인 OrganizationMember 클래스

@Entity
@Getter
@Builder
@NoArgsConstructor(access = AccessLevel.PROTECTED)
@AllArgsConstructor
public class OrganizationMember {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @ManyToOne(fetch = FetchType.LAZY) // CascadeType 제거
    @JoinColumn(name = "organization_id")
    private Organization organization;

    @ManyToOne(fetch = FetchType.LAZY) // CascadeType 제거
    @JoinColumn(name = "member_id")
    private Member member;

    ...
}

 

 

🔍 결과 관찰

Organization 엔티티를 삭제해도 Member 엔티티는 그대로 유지되며, OrganizationMember 테이블의 row만 삭제되는 것을 확인했다. 이를 통해 비즈니스 로직 상 발생할 수 있는 치명적인 오류를 방지하고, 데이터 무결성을 성공적으로 유지할 수 있었다.

 

 

💡 고찰

연관관계에서 CascadeType은 효율적인 기능을 제공하지만, 자칫 잘못 설정하면 의도하지 않은 엔티티 삭제가 발생할 수 있다. 특히 부모-자식 관계에서 CascadeType을 적용할 때, 연관관계의 주인과 방향성을 명확히 이해하는 것이 중요하다. 부모와 자식 관계를 헷갈려 자식 엔티티에 cascade를 적용할 경우, 자식이 삭제될 때 부모도 함께 삭제되는 문제가 발생할 수 있다. 이로 인해 데이터 무결성에 문제가 생기고, 비즈니스 로직에도 치명적인 영향을 줄 수 있다. 이번 문제를 통해 CascadeType의 사용과 연관관계의 주인 개념에 대해 깊은 이해가 필요하다는 것을 깨달았으며, 부모 엔티티에서만 cascade를 신중하게 관리하는 것이 데이터 무결성을 보장할 수 있는 방법임을 알게 되었다.

 

 

📍 참고 자료

• [Spring/JPA] CascadeType.ALL 사용시 주의 해야 할 점
• <JPA> 알고 쓰는 Cascade(영속성 전이)