context deadline exceeded
Operația a durat mai mult decât termenul (timeout) al contextului, iar contextul a fost anulat. Verifică dacă timeout-ul e realist pentru operație, dacă serviciul apelat răspunde lent și tratează eroarea (reîncercare, mesaj clar), în loc să oprești programul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un context.Context creat cu context.WithTimeout sau WithDeadline se anulează singur când expiră termenul. Funcțiile care primesc contextul (cereri HTTP, interogări SQL, apeluri gRPC, funcțiile tale cu select pe ctx.Done()) se opresc atunci și întorc ctx.Err(), adică context deadline exceeded.
Varianta context canceled apare când contextul a fost anulat explicit cu cancel() (de exemplu clientul a închis conexiunea HTTP). La clientul HTTP cu Timeout setat, mesajul complet arată ca Get "https://...": context deadline exceeded (Client.Timeout exceeded while awaiting headers).
Eroarea nu spune ce operație a fost lentă, doar că termenul a expirat. Împachetează-o cu context (fmt.Errorf("citire comenzi: %w", err)) și verifică cu errors.Is(err, context.DeadlineExceeded) dacă vrei să tratezi separat timeout-urile.
De ce apare: cauzele frecvente
1Timeout prea mic pentru operație
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Millisecond)
defer cancel()
raport, err := genereazaRaport(ctx) // durează ~100 msctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()
raport, err := genereazaRaport(ctx)Termenul trebuie ales după durata reală a operației, cu o marjă.
2Context reutilizat după ce a expirat
ctx, cancel := context.WithTimeout(bg, time.Second)
defer cancel()
for _, id := range ids {
descarca(ctx, id) // toate împart aceeași secundă
}for _, id := range ids {
ctx, cancel := context.WithTimeout(bg, time.Second)
descarca(ctx, id)
cancel()
}Dacă fiecare operație trebuie să aibă propriul termen, creează câte un context pentru fiecare.
3Timeout tratat ca eroare fatală
if err != nil {
log.Fatal(err)
}if errors.Is(err, context.DeadlineExceeded) {
log.Println("serviciul răspunde greu, reîncerc")
// reîncercare cu backoff sau răspuns 504
}Un timeout e adesea temporar; tratează-l explicit în loc să oprești tot programul.
Repară eroarea, direct în pagină
Programul generează un raport cu un context cu termen, dar timeout-ul de 20 ms e mult mai mic decât durata operației (aproximativ 50 ms), iar programul se oprește cu context deadline exceeded. Alege un termen realist (de exemplu 1 secundă) ca programul să afișeze Raport gata: 42 comenzi.
package main
import (
"context"
"fmt"
"log"
"time"
)
func genereazaRaport(ctx context.Context) (int, error) {
select {
case <-time.After(50 * time.Millisecond):
return 42, nil
case <-ctx.Done():
return 0, ctx.Err()
}
}
func main() {
ctx, cancel := context.WithTimeout(context.Background(), 20*time.Millisecond)
defer cancel()
n, err := genereazaRaport(ctx)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Raport gata: %d comenzi\n", n)
}Raport gata: 42 comenzi
Indiciu
Termenul contextului trebuie să fie mai mare decât durata operației.
Reparația
package main
import (
"context"
"fmt"
"log"
"time"
)
func genereazaRaport(ctx context.Context) (int, error) {
select {
case <-time.After(50 * time.Millisecond):
return 42, nil
case <-ctx.Done():
return 0, ctx.Err()
}
}
func main() {
ctx, cancel := context.WithTimeout(context.Background(), time.Second)
defer cancel()
n, err := genereazaRaport(ctx)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Raport gata: %d comenzi\n", n)
}De ce merge
Cu un termen de 20 ms, contextul expira înainte ca raportul (50 ms) să fie gata, iar select alegea ramura ctx.Done() și întorcea context deadline exceeded. Cu un termen de o secundă, operația termină prima, iar select alege ramura cu rezultatul 42. defer cancel() eliberează timerul contextului la final.
Alte forme ale mesajului
context canceledGet "https://api.exemplu.ro/date": context deadline exceeded (Client.Timeout exceeded while awaiting headers)panic: context deadline exceeded
Cum o eviți pe viitor
Transmite contextul ca prim parametru (ctx context.Context) prin toate funcțiile care fac I/O și respectă-l (select pe ctx.Done(), http.NewRequestWithContext, db.QueryContext). Alege timeout-uri după măsurători reale, nu după ghicit. Apelează mereu cancel() (cu defer) ca să eliberezi resursele. Pentru servicii externe, combină timeout-ul cu reîncercări limitate.
Întrebări frecvente
De ce trebuie să apelez cancel dacă oricum expiră?
Ca să eliberezi imediat timerul și resursele contextului când operația termină mai devreme. go vet te avertizează dacă uiți cancel.
Care e diferența dintre context canceled și deadline exceeded?
deadline exceeded înseamnă că a expirat timpul. canceled înseamnă că cineva a apelat cancel() sau că s-a anulat un context părinte (de exemplu clientul HTTP a renunțat).
Erori înrudite
fatal error: all goroutines are asleep - deadlock! Toate goroutinele (inclusiv main) așteaptă la un canal sau la un WaitGroup și niciuna nu mai poate continua. Cauze tipice: trimitere fără receptor pe un canal fără buffer, range peste un canal pe care nu îl închide nimeni, wg.Wait() fără Done() suficiente. Dă fiecărei trimiteri un receptor și închide canalul la final. panic: send on closed channel Ai trimis o valoare pe un canal după ce a fost închis cu close. Un canal închis poate fi citit, dar nu mai acceptă trimiteri. Închide canalul o singură dată, doar după ce toți cei care trimit au terminat (de regulă de către cel care trimite, sau după wg.Wait()). dial tcp 127.0.0.1:8080: connect: connection refused Pe adresa și portul la care te conectezi nu ascultă niciun server. Verifică dacă serverul (aplicația, baza de date, containerul) chiar rulează, pe ce port ascultă și dacă te conectezi la hostul corect; în Docker, localhost din container nu e mașina ta. Învață Go de la zero, cu exerciții la fiecare lecție
Curs Go: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
