[트러블슈팅] QueryDSL .count().fetchOne()에서 발생하는 NPE 경고 해결 방법

📌 문제 상황

QueryDSL로 엔티티 개수를 조회할 때 다음과 같은 코드 사용했다.

return queryFactory
    .select(sender.count())
    .from(sender)
    .where(sender.courier.eq(courier), sender.isDeleted.isFalse())
    .fetchOne(); // ⚠️ 경고 발생!

이 코드에서 IDE 또는 컴파일러가 다음과 같은 경고가 띄워졌다.

❗ Unboxing of 'fetchOne()' may produce 'NullPointerException'

 

 

🔍 왜 이런 경고가 발생할까?

• fetchOne()은 nullable한 Long 객체를 반환한다.
• 하지만 반환 타입을 long(기본형)으로 선언해버리면 → 언박싱 과정에서 null이면 NPE 발생!

즉, 이 코드는 실행 중 NPE가 발생할 수 있는 위험이 있다는 의미다.

 

 

🔍 해결 방법

방법 1. Optional을 활용해 안전하게 언박싱

Long count = queryFactory
    .select(sender.count())
    .from(sender)
    .where(sender.courier.eq(courier), sender.isDeleted.isFalse())
    .fetchOne();

return Optional.ofNullable(count).orElse(0L);

방법 2. 삼항 연산자 사용

Long count = queryFactory
    .select(sender.count())
    .from(sender)
    .where(sender.courier.eq(courier), sender.isDeleted.isFalse())
    .fetchOne();

return count != null ? count : 0L;

방법 3. 한 줄로 처리 (가독성이 떨어질 수 있음)

return Optional.ofNullable(
    queryFactory
        .select(sender.count())
        .from(sender)
        .where(sender.courier.eq(courier), sender.isDeleted.isFalse())
        .fetchOne()
).orElse(0L);

 

 

 

💡 언제 null이 반환될 수 있을까?

• .count()는 보통 0을 반환할 것 같지만,
• QueryDSL의 .fetchOne()은 조건이 완전히 배제되면 null이 될 수 있음
• 따라서 안전하게 null 체크를 해주는 것이 좋다.