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

ERROR: canceling statement due to statement timeout

Pe scurt

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ă

Greșit
SELECT client_id, SUM(total) FROM comenzi
 WHERE creata_la >= now() - interval '1 year'
 GROUP BY client_id;   -- pe primară, în timpul zilei
Corect
-- pe replica de raportare, cu utilizatorul raportare:
ALTER ROLE raportare SET statement_timeout = '5min';
-- sau tabel agregat, actualizat noaptea

Raportul nu mai concurează cu comenzile clienților, iar timeout-ul strict rămâne pentru aplicație.

2Timeout dezactivat ca să „meargă”

Greșit
SET statement_timeout = 0;
Corect
SET statement_timeout = '2s';   -- aplicația
-- interogarea lentă: EXPLAIN ANALYZE, apoi index

Fără timeout, problema nu dispare, doar se mută: baza rămâne blocată mai mult.

Repară tu

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.

Alte forme ale mesajului

  • ERROR: canceling statement due to user request
  • ERROR: canceling statement due to lock timeout
  • QueryCanceledError: canceling statement due to statement timeout

Cum o eviți pe viitor

  • Pune statement_timeout pe 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

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