...
Eroare Go · Goroutine și canale

context deadline exceeded

Pe scurt

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

Greșit
GO
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Millisecond)
defer cancel()
raport, err := genereazaRaport(ctx) // durează ~100 ms
Corect
GO
ctx, 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

Greșit
GO
ctx, cancel := context.WithTimeout(bg, time.Second)
defer cancel()
for _, id := range ids {
	descarca(ctx, id) // toate împart aceeași secundă
}
Corect
GO
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ă

Greșit
GO
if err != nil {
	log.Fatal(err)
}
Corect
GO
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ă tu

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.

Codul care dă eroarea
GO
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)
}
După reparație, programul afișează
Raport gata: 42 comenzi
Indiciu

Termenul contextului trebuie să fie mai mare decât durata operației.

Alte forme ale mesajului

  • context canceled
  • Get "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

← Toate erorile Go

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ță 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.