본문 바로가기
삵

HikariCP로 커넥션 누수 잡아내기

조회 0 · 댓글 0
고고구마엔사이다작성자2026년 11월 20일

커넥션 풀이 금방 고갈되는데 어느 코드가 커넥션을 쥐고 안 돌려주는지 모를 때가 있습니다. HikariCP의 leakDetectionThreshold를 켜두면 커넥션이 풀 밖으로 나간 채 설정 시간을 넘겼을 때 커넥션 누수 가능성을 알리는 메시지를 로그로 남겨줍니다. 공식 README 기준으로 이 값은 밀리초 단위이고 기본값은 0(비활성)입니다.

활성화하려면 0보다 큰 값을 주는데, 켤 수 있는 최솟값은 2000(2초)입니다. 운영 쿼리 중 정상적으로 2초를 넘는 작업이 있으면 오탐이 섞일 수 있으니 처음에는 넉넉히 잡고 로그를 보며 줄이는 편이 안전합니다.

설정 예시는 다음과 같습니다.

HikariConfig config = new HikariConfig();
config.setLeakDetectionThreshold(30000); // 30s, 단위는 ms

// Spring Boot application.yml
spring:
  datasource:
    hikari:
      leak-detection-threshold: 30000

주의: README에서 자주 쓰지 않는(infrequently used) 속성으로 분류돼 있습니다. 상시 켜두기보다 누수가 의심될 때 켜서 범인 코드를 찾고, 확인 후에는 0으로 되돌려 두는 쪽이 깔끔합니다.

🔗 https://github.com/brettwooldridge/HikariCP/blob/dev/README.md

로그인 후 답글을 남길 수 있습니다.