ERROR: canceling statement due to statement timeout
PostgreSQL a oprit interogarea pentru că a rulat mai mult decât `statement_timeout`. Timeout-ul și-a făcut treaba: a protejat baza de o interogare prea lungă. Optimizează interogarea (index, mai puține date), mut-o pe o replică sau precalculează rezultatul; nu dezactiva timeout-ul global.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
statement_timeout e o plasă de siguranță: nicio interogare nu are voie să ruleze peste limita dată. Fără ea, o interogare scăpată (un raport pe tot istoricul, un JOIN fără condiție) poate ține CPU-ul și lock-urile minute întregi și poate încetini toate celelalte cereri.
Când vezi mesajul, întreabă-te două lucruri. Interogarea ar trebui să fie rapidă? Atunci e o problemă de plan: lipsește un index, se citesc prea multe date, sau baza e supraîncărcată și totul merge mai lent. Interogarea e legitim lungă (rapoarte, exporturi)? Atunci nu are ce căuta pe baza primară, în drumul cererilor utilizatorilor: rulează pe o replică sau într-un sistem de analiză, cu propriul timeout, ori se precalculează periodic.
Tranzacția în care a apărut eroarea e anulată; trebuie făcut ROLLBACK înainte de alte comenzi pe aceeași conexiune.
De ce apare: cauzele frecvente
1Raport greu pe baza primară
SELECT client_id, SUM(total) FROM comenzi
WHERE creata_la >= now() - interval '1 year'
GROUP BY client_id; -- pe primară, în timpul zilei-- pe replica de raportare, cu utilizatorul raportare:
ALTER ROLE raportare SET statement_timeout = '5min';
-- sau tabel agregat, actualizat noapteaRaportul nu mai concurează cu comenzile clienților, iar timeout-ul strict rămâne pentru aplicație.
2Timeout dezactivat ca să „meargă”
SET statement_timeout = 0;SET statement_timeout = '2s'; -- aplicația
-- interogarea lentă: EXPLAIN ANALYZE, apoi indexFără timeout, problema nu dispare, doar se mută: baza rămâne blocată mai mult.
Repară eroarea, direct în pagină
Răspunde la cele trei întrebări despre canceling statement due to statement timeout.
Indiciu
Timeout-ul e o protecție; întrebarea e de ce interogarea durează atât și unde ar trebui să ruleze.
Reparația
- q1: A oprit o interogare care a depășit
statement_timeout. - q2: replică cu timeout propriu, agregate precalculate, indexuri.
- q3: Adevărat.
De ce merge
Timeout-ul a oprit o interogare lungă înainte să afecteze restul bazei. Raportul trebuie mutat pe o replică sau precalculat, iar timeout-ul strict rămâne pentru aplicație; dezactivarea lui globală ar expune baza.
Alte forme ale mesajului
ERROR: canceling statement due to user requestERROR: canceling statement due to lock timeoutQueryCanceledError: canceling statement due to statement timeout
Cum o eviți pe viitor
- Pune
statement_timeoutpe utilizatorul aplicației (de exemplu câteva secunde). - Rulează rapoartele și exporturile pe replici sau într-un depozit de date.
- Precalculează agregatele folosite des.
- Urmărește interogările care ating timeout-ul: sunt candidații pentru optimizare.
Întrebări frecvente
Ce diferă față de lock timeout?
lock_timeout limitează doar așteptarea unui lock. statement_timeout limitează toată durata interogării, inclusiv execuția.
Trebuie să fac ROLLBACK?
Da, dacă erai într-o tranzacție: după eroare, tranzacția e în stare eșuată și orice altă comandă dă current transaction is aborted până la ROLLBACK.
Erori înrudite
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. Lock wait timeout exceeded; try restarting transaction Tranzacția ta a așteptat mai mult de `innodb_lock_wait_timeout` (implicit 50 de secunde) un lock pe rânduri ținute de altă tranzacție. Găsește tranzacția care ține lock-ul (`INNODB_TRX`, `innodb_lock_waits`) și scurteaz-o: fără lucru lent sau tranzacții uitate deschise. Baza de date primară la 100% CPU din cauza citirilor Majoritatea interogărilor sunt citiri, iar baza primară, singura care le servește, a ajuns la limită. Mută citirile pe replici de citire (read replicas) și pune un cache în față pentru datele citite des; primara rămâne pentru scrieri. Î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.
