Connection Pool 고갈 증상

# 1. Java 프로세스의 스레드 덤프를 추출하여 HikariCP 관련 대기(WAITING) 상태의 스레드 수를 집계
$ jstack $(pgrep -f "spring-boot-app.jar") | grep "HikariPool" | grep "WAITING" | wc -l

# 2. 애플리케이션 로그에서 커넥션 획득 실패(Timeout) 에러 발생 확인
$ grep -A 2 "Connection is not available" /var/log/app/application.log | tail -n 5

# jstack 결과 (대기 중인 스레드 수)
154

# 로그 grep 결과
2026-03-09 22:45:10.123 ERROR [http-nio-8080-exec-15] com.zaxxer.hikari.pool.HikariPool : HikariPool-1 - Connection is not available, request timed out after 30000ms.
2026-03-09 22:45:10.123 ERROR [http-nio-8080-exec-15] org.hibernate.exception.JDBCConnectionException : Unable to acquire JDBC Connection

import org.springframework.stereotype.Service
import org.springframework.transaction.annotation.Transactional
import org.slf4j.LoggerFactory

// [안티 패턴]: 외부 API 호출 시간 동안 DB 커넥션을 불필요하게 점유함
@Service
class BadOrderService(
    private val orderRepository: OrderRepository,
    private val paymentClient: PaymentClient
) {
    @Transactional
    fun processOrderBad(orderId: Long) {
        // 1. 커넥션 획득 및 로직 수행
        val order = orderRepository.findById(orderId) 
        
        // 2. 문제 발생 구간: 외부 네트워크 통신 (예: 3초 소요)
        // 이 3초 동안 DB 커넥션은 아무 작업도 하지 않으면서 반납되지 않고 유지됨
        paymentClient.pay(order.amount) 
        
        // 3. 상태 변경 및 트랜잭션 커밋, 커넥션 반납
        order.complete() 
    }
}


// [해결 방안]: 트랜잭션 경계를 최소화하여 DB 커넥션 점유 시간을 단축
@Service
class GoodOrderFacade(
    private val orderQueryService: OrderQueryService,
    private val paymentClient: PaymentClient,
    private val orderCommandService: OrderCommandService
) {
    private val log = LoggerFactory.getLogger(this::class.java)

    // @Transactional 어노테이션을 상위 메서드에서 제거함
    fun processOrderGood(orderId: Long) {
        // 1. 필요한 데이터만 짧은 트랜잭션으로 조회 (커넥션 즉시 반납)
        val orderAmount = orderQueryService.getOrderAmount(orderId)
        
        // 2. 외부 API 호출 (DB 커넥션을 점유하지 않은 상태에서 실행됨)
        // 외부 API가 타임아웃(3초)이 발생하더라도 DB 커넥션 풀에는 영향을 주지 않음
        try {
            paymentClient.pay(orderAmount)
        } catch (e: Exception) {
            log.error("Payment failed", e)
            throw RuntimeException("결제 처리 중 오류 발생")
        }
        
        // 3. 상태 변경을 위한 짧은 트랜잭션 실행 (커넥션 잠깐 점유 후 즉시 반납)
        orderCommandService.completeOrder(orderId)
    }
}

@Service
class OrderQueryService(private val orderRepository: OrderRepository) {
    @Transactional(readOnly = true)
    fun getOrderAmount(orderId: Long): Long {
        return orderRepository.findById(orderId).amount
    }
}

@Service
class OrderCommandService(private val orderRepository: OrderRepository) {
    @Transactional
    fun completeOrder(orderId: Long) {
        orderRepository.findById(orderId).complete()
    }
}