JPA-메소드 이름 기반 쿼리 & JPQL

Spring Boot JPA에서 첫 번째 메소드가 동작하지 않고 두 번째 메소드가 정상적으로 동작하는 이유는 메소드 네이밍 규칙과 JPQL 쿼리의 차이 때문입니다.

첫 번째 방식:

@Modifying
@Transactional
void deleteAllByPostId(Long postId);

이 방식은 메소드 이름 기반 쿼리(method name query strategy)를 사용합니다. 하지만 여기서 문제는 JPA가 PostComment 엔티티에서 postId라는 필드를 직접 찾으려고 시도한다는 점입니다.

실제로는 PostComment 엔티티가 아마도 다음과 같은 구조일 것입니다:

class PostComment {
    @Id
    private Long id;
    
    @ManyToOne
    private Post post;  // post.id가 postId에 해당함
    
    // 다른 필드들...
}

여기서 postId라는 필드는 직접 존재하지 않고, post 객체를 통해 간접적으로 참조됩니다. JPA의 메소드 이름 기반 쿼리는 이러한 복합 속성 경로를 올바르게 처리하지 못하는 경우가 있습니다.

두 번째 방식:

@Transactional
@Modifying
@Query("delete from PostComment pc where pc.post.id = :postId")
void deleteAllByPostId(@Param("postId") Long postId);

이 방식은 명시적으로 JPQL 쿼리를 정의했기 때문에 정확히 어떤 경로를 통해 postId를 찾아야 하는지 명확하게 지정합니다 (pc.post.id). 따라서 JPA가 정확히 어떤 조건으로 삭제할지 이해할 수 있어 정상 작동합니다.

메소드 이름 기반 쿼리를 사용하려면 다음과 같이 수정해야 합니다:

@Modifying
@Transactional
void deleteAllByPost_Id(Long postId);  // 언더스코어로 관계를 표현

이렇게 하면 JPA가 post 관계를 통해 id 필드에 접근한다는 것을 이해하고 올바르게 처리할 수 있습니다.