Keycloak Could not obtain connection to query metadata: java.sql.SQLException: Acquisition timeout while waiting for new connection 예외

😒 배경

Window 환경에서 MSA 학습 중 keycloak(21.0.1 버전)을 활용해 인증 처리를 구현해서 사용하던 중,

갑자기 keycloak을 실행할 때 다음과 같은 예외가 반복되면서 실행이 되지 않았다.

 

실행한 명령어 = kc.bat start-dev --http-port 8180

 

Could not obtain connection to query metadata: java.sql.SQLException: Acquisition timeout while waiting for new connection

🔎 원인

해당 문제를 찾아보니, 원인에 대한 다양한 의견이 있었지만 명확한 답은 없었다.

 

1. 지정된 URL에서 실행 중인 데이터베이스 서버가 없을 때 발생한다.

2. Hyper-V가 문제다.

📖 해결

필자가 찾은 해결 방법은 옵션에 데이터베이스 풀 개수(--db-pool-initial-size)를 설정하는 방법이었다.

 

kc.bat start-dev --http-port 8180 --db-pool-initial-size 10

 

해당 옵션을 추가하고 실행하면 정상적으로 동작한다.

REFERENCE

https://github.com/keycloak/keycloak/issues/16448

https://stackoverflow.com/questions/76007973/error-in-starting-keycloak-dev-environment-server