HikariPool-1 - Connection is not available, request timed out after 30000ms.
Toate conexiunile din pool-ul Hikari au fost ocupate 30 de secunde, iar cererea a renunțat. Fie pool-ul e prea mic pentru câte interogări rulează simultan, fie interogările (sau tranzacțiile) durează prea mult, fie o conexiune nu e eliberată. Calculează cu legea lui Little câte conexiuni îți trebuie și caută interogările lente.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
HikariCP e pool-ul implicit în Spring Boot. Mesajul complet (java.sql.SQLTransientConnectionException: HikariPool-1 - Connection is not available, request timed out after 30000ms.) apare când un thread cere o conexiune și niciuna nu se eliberează în connectionTimeout (implicit 30 de secunde). Versiunile noi adaugă (total=10, active=10, idle=0, waiting=37), adică exact starea pool-ului.
Câte conexiuni sunt ocupate depinde de doi factori: câte cereri vin pe secundă și cât timp ține fiecare conexiunea. Legea lui Little dă media: conexiuni ocupate = cereri/s × durata. La 400 de cereri pe secundă și 50 ms per cerere, ai nevoie în medie de 20 de conexiuni; cu un pool de 10, cererile se adună la coadă.
Cauze frecvente: o interogare fără index care ține conexiunea secunde, o tranzacție care include un apel HTTP extern, @Transactional pe o metodă lungă, sau un leak (conexiune luată și nedată înapoi, vizibil cu leakDetectionThreshold).
De ce apare: cauzele frecvente
1Apel extern în interiorul tranzacției
@Transactional
public void plaseaza(Comanda c) {
repo.save(c);
plati.incaseaza(c); // 2 secunde, conexiunea e ținută
}public void plaseaza(Comanda c) {
salveaza(c); // tranzacție scurtă
plati.incaseaza(c); // în afara tranzacției
}Conexiunea e ocupată cât durează tranzacția. Apelurile lente făcute în tranzacție blochează pool-ul.
2Leak de conexiune ascuns
spring.datasource.hikari.maximum-pool-size=10spring.datasource.hikari.maximum-pool-size=10
spring.datasource.hikari.leak-detection-threshold=20000Cu detectarea de leak, Hikari scrie în log stiva de unde a fost luată conexiunea nedată înapoi.
Repară eroarea, direct în pagină
Aplicația primește HikariPool-1 - Connection is not available la vârf. Pool-ul are 10 conexiuni, o instanță primește 400 de cereri pe secundă, iar fiecare ține conexiunea 50 ms. Fă cele două calcule din tab-ul Estimări.
Indiciu
Legea lui Little: elemente în sistem = rata de sosire × timpul petrecut în sistem.
Reparația
- e1: 400 × 0,05 = 20 de conexiuni ocupate (pool-ul are doar 10).
- e2: 400 × 0,02 = 8 conexiuni.
De ce merge
Media de 20 de conexiuni ocupate depășește pool-ul de 10, deci cererile așteaptă. Optimizarea interogării la 20 ms reduce necesarul la 8: de multe ori e mai bine să scurtezi timpul decât să mărești pool-ul.
Alte forme ale mesajului
java.sql.SQLTransientConnectionException: HikariPool-1 - Connection is not available, request timed out after 30000ms (total=10, active=10, idle=0, waiting=37)Unable to acquire JDBC ConnectionApparent connection leak detected
Cum o eviți pe viitor
- Dimensionează pool-ul cu legea lui Little, apoi verifică limita bazei pentru toate instanțele.
- Ține tranzacțiile scurte: fără apeluri HTTP sau procesări lungi în ele.
- Activează
leakDetectionThresholdîn testare. - Monitorizează metricile Hikari (
active,pending) și timpul de obținere a conexiunii.
Întrebări frecvente
Rezolv mărind pool-ul la 100?
Doar dacă baza poate executa atâtea interogări simultan, iar suma pool-urilor tuturor instanțelor încape în limita ei. De obicei e mai eficient să scurtezi timpul cât e ținută conexiunea.
De ce apare doar la vârf?
Pentru că numărul de conexiuni necesare crește proporțional cu traficul. Sub o anumită rată, pool-ul ajunge; peste ea, cererile încep să aștepte și timpul de așteptare crește brusc.
Erori înrudite
FATAL: sorry, too many clients already PostgreSQL a atins `max_connections` (implicit 100) și refuză conexiuni noi. Apare tipic după scalarea aplicației: fiecare instanță are propriul pool, iar suma lor depășește limita. Calculează instanțe × mărimea pool-ului, micșorează pool-urile și pune un pooler (PgBouncer) în față. sqlalchemy.exc.TimeoutError: QueuePool limit of size 5 overflow 10 reached, connection timed out, timeout 30.00 Pool-ul SQLAlchemy (5 conexiuni + 10 suplimentare) a rămas fără conexiuni libere 30 de secunde. Cel mai des, sesiunile nu sunt închise (leak) sau o cerere ține conexiunea foarte mult. Folosește `with Session(...)` sau dependințe care închid sesiunea, apoi dimensionează pool-ul. Slow query: Seq Scan pe un tabel mare (index lipsă) Interogarea citește tot tabelul rând cu rând (`Seq Scan` în PostgreSQL, `type: ALL` în MySQL) pentru că nu există un index pe coloana din `WHERE`. Pe tabele mari, fiecare citire durează și încarcă baza. Rulează `EXPLAIN ANALYZE`, creează indexul potrivit și verifică din nou planul. Învață System Design de la zero, cu exerciții la fiecare lecție
Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
