org.hibernate.type: trace 가 작동하지 않는 현상 해결

문제 파악

보통 스프링을 디버깅할 때 SQL 쿼리 로그를 확인하는 선에서 끝나지만, 종종 DataSource나 DDL 이 오류가 발생하거나 예상하지 못한 값이 DB에서 관측될 때는 SQL 쿼리에 포함된 값을 확인할 필요가 있다. 하지만 우리는 Hibernate ORM을 사용하기 때문에 SQL 쿼리에는 바인딩되기 전의 쿼리만 볼 수 있다.

 

이때 필요한 것이 binding parmater를 추적하는 것인데, 처음 스프링을 배울 때 배운 방법이 작동하지 않았다.

(application.properties)

logging:
    level:
        org:
            hibernate:
                type: trace

 

이전에 진행한 프로젝트에서 똑같이 실행하면 정상적으로 실행된다.

---

 

트러블 슈팅

문제 원인 분석

현 프로젝트와 이전 프로젝트 차이라면 모듈 구조와 버전 정도인데, 구글링 결과 스프링 버전에 따른 Hibernate 버전 차이가 원인이였다. Hibernate 공식 문서를 통해 확인해보자.

Hibernate ORM 5.6.15.Final User Guide

Hibernate ORM 6.1.7.Final User Guide

Spring boot 3.0.13부터는 Hibernate 6.1.7.Final 이상과 호환되는데, 해당 버전부터 JDBC bind parameter 로깅을 설정하는 방식이 바뀌었다.

 

문제 해결

따라서 다음과 같이 application.properties를 변경하면, 정상적으로 로그가 나온다. 자세히보면 로그를 찍는 패키지가 변경되었다.

logging:
    level:
        org:
            hibernate:
                orm:
                    jdbc:
                        bind: trace

 

 

기타

Hibernate 문서에서는 log4j.logger.org.hibernate.orm.jdbc.bind 인데, 왜 실제 코드에서는 logger.level.org.hibernate.orm.jdbc.bind 를 쓰냐고 물으신다면...

문서를 자세히 읽어봐야 한다. Hibernate는 JPA의 구현체인 것과 마찬가지로, 스프링의 로깅 시스템의 구현체 중 하나인 Log4j를 문서가 예를 들었을 뿐이다.

 

스프링 부트의 로깅 시스템을 지원하는 모든 Logger는 logger.level이 설정되어 있기 때문에, 다형성있게 스프링 부트 설정을 따르면 된다.

Spring Boot Reference - Core Features