📚[Spring] Soft Delete

논리적 삭제(Soft Delete)

DB에서 실제 데이터를 삭제하는것이 아닌 deleted 와 같은 삭제 여부를 나타내는 필드를
추가하여 데이터의 상태를 관리하는 방법이다.

public abstract class BaseEntity {
    ...
    @Column(nullable = false)
    private Boolean deleted = false;
    ...
}

BaseEntity 에 해당 필드를 추가하여 데이터의 상태를 추적하도록 설계했다.

---

삭제 로직 변경

기존 삭제 메서드

public void delete(Long id, CustomUserDetails userDetails) {
    Post foundPost = postDomainUtils.validateUserAccessToPost(id, userDetails);
    postRepository.delete(foundPost); // DB에서 데이터가 삭제됨
}

JPA Repository의 기본 delete 메서드를 사용하면 실제 DB 데이터가 삭제되기에
논리적 삭제를 적용할 경우 아래와 같이 삭제 메서드의 변경이 필요하다.

//service
@Transactional
public void delete(Long id, CustomUserDetails userDetails) {
    Post foundPost = postDomainUtils.validateUserAccessToPost(id, userDetails);
    foundPost.setDeleted(true); // 상태값 변경으로 논리적 삭제 처리
}

엔티티의 deleted 필드를 true 로 변경하는 방식으로
JPA 의 더티체킹(dirty checking)에 의해 변경사항이 자동으로 DB에 반영된다.

---

데이터 조회 방법

논리적 삭제 시 DB에는 데이터가 그대로 존재하기 때문에 findById(id)와 같이 기본 조회 메서드 호출 시 삭제된 데이터도 조회될 수 있다.
따라서 논리적 삭제를 적용하면 조회 로직을 변경해야 한다.

다음 두 가지 방법이 대표적이다.

---

1. @Where 어노테이션 활용

...
@Where(clause = "deleted = false")
public class Post extends BaseEntity { ... }

해당 어노테이션을 붙이면 Hibernate 가 엔티티 조회 시 항상 deleted = false 조건을 자동으로 추가해준다.
간단하고 편리하지만 Hibernate 전용 기능이고 최근 버전에서 deprecated 되어 사용이 권장되지 않는다는 단점이 있다.

너무 숨겨진 필터라 디버깅이 힘들어 더 명시적인 쿼리 필터링 방식을 권장함

---

2. 명시적 조건을 포함한 메서드 선언

public interface PostRepository extends JpaRepository<Post, Long> {
    Optional<Post> findByIdAndDeletedFalse(Long id);
}

조회 메서드에 deleted = false 조건을 명시적으로 포함시켜서 조회한다.
JPA 표준 방식이고 deprecated 문제도 없으며 메서드 이름에 조건이 명확해 가독성과 디버깅에 유리하다.
단 사용하는 메서드마다 조건을 직접 추가해야 하는 단점이 있다.

---

정리

방법	장점	단점
@Where 어노테이션	자동 필터링, 간단함	Hibernate 전용, deprecated됨
명시적 조건 메서드 선언	JPA 표준, 가독성 좋음, deprecated 문제 없음	매번 조건을 추가해야 번거로움

---

팀 회의에서 논리적 삭제 구현 시 위 두 가지 조회 방법을 제안할 예정이다.
현재 프로젝트 상황과 유지보수 편의성을 고려해 선택할 수 있도록 안내하면 좋을 것 같다.