트래픽이 오를 때 API가 갑자기 느려지고 로그에 ‘풀에서 연결을 받지 못했다’는 오류가 보입니다. 즉시 연결 풀 크기를 두 배로 키우면 해결될까요? 잠시 나아질 수 있지만 여러 앱 인스턴스가 동시에 연결을 늘리면 DB 자체의 한도를 먼저 소진할 수도 있습니다. 연결 풀은 DB를 빠르게 만드는 버튼이 아니라 제한된 연결을 재사용하고 대기시키는 장치입니다.
연결을 ‘만드는 비용’과 ‘빌리는 시간’을 나눈다
새 DB 연결을 맺는 데는 인증과 네트워크 비용이 듭니다. 풀은 한 번 만든 연결을 다음 요청이 재사용하게 합니다. 요청이 쿼리를 실행할 때 연결을 빌리고, 작업이 끝나면 반환합니다. 여기서 중요한 지표는 쿼리 실행 시간뿐 아니라 연결을 기다린 시간과 연결을 잡고 있던 시간입니다. DB가 빠른데도 연결이 반환되지 않으면 뒤 요청은 풀 앞에서 줄을 섭니다.
SQLAlchemy의 연결 풀 문서는 유지할 풀 크기와 일시적으로 넘길 수 있는 연결 수, 기다리는 시간 제한을 구분합니다. 설정한 최대 크기는 앱 프로세스 하나의 값입니다. 웹 서버가 여러 프로세스를 띄우거나 배포로 인스턴스를 늘리면 가능한 연결의 합계도 늘어납니다. DB 한도는 앱 외의 관리자 세션, 배치 작업, 모니터링에도 남겨 둬야 합니다.
풀 고갈의 원인이 정말 연결 부족인가
연결을 반환하지 않는 코드, 오랫동안 열려 있는 트랜잭션, 외부 API 응답을 기다리며 DB 연결을 잡고 있는 흐름, 많은 행을 천천히 순회하는 작업이 흔한 원인입니다. 이 상태에서 풀만 키우면 문제를 숨기면서 DB의 동시 작업량을 늘립니다. SQLAlchemy의 풀 시간 초과 설명도 우선 연결 누수나 오래 걸리는 트랜잭션을 조사하도록 안내합니다.
연결을 여는 위치와 닫는 위치를 코드에서 짝지어 확인합니다. 웹 요청 중 DB 처리가 끝났다면 외부 네트워크 호출을 기다리는 동안 연결을 계속 쥐고 있지 않게 합니다. 실패했을 때도 트랜잭션이 롤백되고 연결이 반환되는지 테스트합니다. 한 화면에서 반복 쿼리를 지나치게 보내는 경우에는 쿼리 구조를 개선하는 편이 풀 확장보다 효과적일 수 있습니다.
전체 수용량은 곱셈으로 계산한다
앱 인스턴스마다 풀 상한이 있으면 전체 잠재 연결 수는 각 인스턴스의 상한을 합한 값입니다. 배치와 관리자 작업도 여기에 더합니다. 예를 들어 배포 중 구버전과 신버전이 동시에 동작하면 평소보다 프로세스가 더 많아집니다. 따라서 평상시 최대치만 보지 말고 배포, 급증, 장애 복구 때도 DB가 받아들일 수 있는지 계산합니다. 무제한으로 넘치는 풀 설정은 앱의 대기 오류를 DB 전체 장애로 옮길 위험이 있습니다.
ORM 객체 풀과 DB 연결 풀도 혼동하지 않습니다. Microsoft의 EF Core 성능 문서는 DbContext 풀링과 실제 DB 드라이버의 연결 풀링이 별개라고 설명합니다. 컨텍스트 재사용을 켠 것만으로 DB 연결 한도가 조절되지는 않습니다.
관측과 제한을 함께 설계한다
풀에서 사용 중인 연결, 비어 있는 연결, 대기 요청, 대기 시간, 시간 초과 수를 봅니다. DB에서는 활성 연결과 오래 실행되는 쿼리를 확인합니다. 부하 테스트는 평균 응답시간만 보지 말고 동시 요청이 늘 때 대기열이 어디에서 자라는지 관찰합니다. 특히 느린 외부 서비스와 함께 실행되는 경로를 포함해야 실제 운영과 비슷합니다.
DB가 감당할 수 없는 요청을 끝없이 쌓아 두는 것은 친절하지 않습니다. 대기 제한을 두고 적절한 오류를 반환하며, 무거운 배치 작업은 웹 요청과 별도의 동시성 제한을 사용합니다. 풀 설정은 DB 용량과 코드의 연결 보유 시간, 인스턴스 수를 함께 보고 조정해야 합니다.
점검 체크리스트
- 프로세스·인스턴스·배치 작업의 잠재 연결 수를 합산했는가?
- 연결 대기 시간과 보유 시간을 분리해 측정하는가?
- 긴 트랜잭션, 누수, 외부 호출 중 연결 보유를 찾았는가?
- 배포 중 인스턴스 중복까지 용량에 반영했는가?
- DB를 보호할 대기 시간과 동시성 제한이 있는가?
연결 풀이 부족해 보일 때 첫 질문은 ‘몇 개로 늘릴까’가 아닙니다. ‘누가 얼마나 오래 연결을 쓰고 있으며 전체 서비스가 몇 개를 열 수 있는가’입니다.
#DB연결풀 #커넥션풀 #데이터베이스 #풀고갈 #동시요청 #백엔드성능 #SQLAlchemy #EFCore #트랜잭션 #서비스운영
