커넥션 풀 튜닝 — HikariCP 설정으로 DB 성능을 끌어올리는 방법

spring:
  datasource:
    hikari:
      # 풀 크기
      maximum-pool-size: 10        # 최대 커넥션 수 (기본: 10)
      minimum-idle: 10             # 최소 유휴 커넥션 수 (기본: maximum-pool-size)

      # 타임아웃
      connection-timeout: 30000    # 커넥션 대기 최대 시간 ms (기본: 30초)
      idle-timeout: 600000         # 유휴 커넥션 유지 시간 ms (기본: 10분)
      max-lifetime: 1800000        # 커넥션 최대 수명 ms (기본: 30분)

      # 누수 탐지
      leak-detection-threshold: 60000  # 커넥션 누수 감지 ms (기본: 0=비활성)

      # 커넥션 검증
      connection-test-query: SELECT 1  # 커넥션 유효성 검사 쿼리
      validation-timeout: 5000        # 검증 타임아웃 ms

풀 크기 = (코어 수 * 2) + 유효 스핀들 수

풀 크기 = 동시 활성 스레드 수 × DB 커넥션 사용 비율

// 메트릭으로 풀 사용량 모니터링
@Bean
public HikariDataSource dataSource() {
    HikariDataSource ds = new HikariDataSource();
    ds.setMetricsTrackerFactory(
        new MicrometerMetricsTrackerFactory(meterRegistry));
    return ds;
}

HikariCP maxLifetime = DB wait_timeout - 여유 시간

spring:
  datasource:
    hikari:
      # MySQL wait_timeout이 28800초(8시간)라면
      # HikariCP는 그보다 짧게 설정
      max-lifetime: 1740000  # 29분 (기본 30분보다 약간 짧게)

spring:
  datasource:
    hikari:
      leak-detection-threshold: 60000  # 60초 이상 반환하지 않으면 경고

WARN  HikariPool-1 - Connection leak detection triggered for conn0
  java.lang.Exception: Apparent connection leak detected
    at com.example.service.SlowService.processData(SlowService.java:42)
    at ...

// 누수 발생: try-with-resources 미사용
public void leakyMethod() {
    Connection conn = dataSource.getConnection();
    PreparedStatement ps = conn.prepareStatement("SELECT ...");
    ResultSet rs = ps.executeQuery();
    // conn.close()를 호출하지 않으면 커넥션이 풀에 반환되지 않음
    // 예외 발생 시 더 위험
}

// 올바른 방법: try-with-resources
public void safeMethod() {
    try (Connection conn = dataSource.getConnection();
         PreparedStatement ps = conn.prepareStatement("SELECT ...");
         ResultSet rs = ps.executeQuery()) {
        // 자동으로 close → 풀에 반환
    }
}

// Spring에서는 JdbcTemplate이나 JPA를 사용하면 커넥션 관리를 자동으로 처리

@Configuration
public class DataSourceConfig {

    @Bean
    @ConfigurationProperties("spring.datasource.primary.hikari")
    public HikariDataSource primaryDataSource() {
        return new HikariDataSource();
    }

    @Bean
    @ConfigurationProperties("spring.datasource.secondary.hikari")
    public HikariDataSource secondaryDataSource() {
        return new HikariDataSource();
    }
}

spring:
  datasource:
    primary:
      hikari:
        jdbc-url: jdbc:mysql://primary-db:3306/main
        maximum-pool-size: 15
    secondary:
      hikari:
        jdbc-url: jdbc:mysql://secondary-db:3306/analytics
        maximum-pool-size: 5  # 분석용 DB는 적은 풀

public class RoutingDataSource extends AbstractRoutingDataSource {

    @Override
    protected Object determineCurrentLookupKey() {
        return TransactionSynchronizationManager.isCurrentTransactionReadOnly()
            ? "read" : "write";
    }
}

@Configuration
public class RoutingConfig {

    @Bean
    public DataSource routingDataSource(
            @Qualifier("writeDataSource") DataSource write,
            @Qualifier("readDataSource") DataSource read) {
        RoutingDataSource routing = new RoutingDataSource();
        Map<Object, Object> targetDataSources = new HashMap<>();
        targetDataSources.put("write", write);
        targetDataSources.put("read", read);
        routing.setTargetDataSources(targetDataSources);
        routing.setDefaultTargetDataSource(write);
        return routing;
    }
}