...
Eroare System Design · Baza de date: conexiuni, lock-uri, interogări lente

HikariPool-1 - Connection is not available, request timed out after 30000ms.

Pe scurt

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

Greșit
@Transactional
public void plaseaza(Comanda c) {
    repo.save(c);
    plati.incaseaza(c);   // 2 secunde, conexiunea e ținută
}
Corect
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

Greșit
spring.datasource.hikari.maximum-pool-size=10
Corect
spring.datasource.hikari.maximum-pool-size=10
spring.datasource.hikari.leak-detection-threshold=20000

Cu detectarea de leak, Hikari scrie în log stiva de unde a fost luată conexiunea nedată înapoi.

Repară tu

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.

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 Connection
  • Apparent 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

← Toate erorile System Design

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.