JPA @Query에서 null 파라미터가 bytea로 추론되어 lower 호출이 실패하는 문제와 해결 방법을 정리했다.

현상

JPA @Query에서 파라미터가 null일 때 아래 오류가 발생했다.

ERROR: function lower(bytea) does not exist
Hint: No function matches the given name and argument types. You might need to add explicit type casts.

원인

PostgreSQL은 null 파라미터의 타입을 추론해야 하는데, Hibernate가 null 값을 바인딩할 때 문맥에 따라 bytea로 추론되는 경우가 있다. 이때 lower(bytea)가 되어 오류가 발생한다.

문제 발생 쿼리

아래 쿼리는 :name 또는 :email이 null일 때 bytea 추론 문제가 발생할 수 있다.

@Query("""
        select c from CompanyEntity c
        where (:name is null or lower(c.name) like lower(concat('%', :name, '%')))
          and (:email is null or lower(c.contactEmail) like lower(concat('%', :email, '%')))
        """)

해결

coalesce로 파라미터가 항상 문자열로 해석되도록 고정한다.

@Query("""
        select c from CompanyEntity c
        where (
            coalesce(:keyword, '') = ''
            or lower(c.name) like lower(concat('%', :keyword, '%'))
            or lower(c.contactEmail) like lower(concat('%', :keyword, '%'))
        )
        """)

coalesce(:keyword, '')에서 ''가 문자열 리터럴이므로 :keyword도 문자열로 타입이 고정된다. 이로 인해 null이어도 lower가 문자열을 대상으로 동작한다.