panic: errors: target must be a non-nil pointer
Ai dat lui errors.As variabila țintă în loc de adresa ei. Al doilea argument trebuie să fie un pointer la o variabilă de tipul erorii căutate: errors.As(err, &e), nu errors.As(err, e).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
errors.As(err, target) caută în lanțul de erori una de un anumit tip și, dacă o găsește, o scrie în variabila ta. Ca să poată scrie, are nevoie de adresa variabilei. Dacă dai variabila însăși (de exemplu un pointer nil de tip *EroareStoc), funcția nu are unde să pună rezultatul și oprește programul cu panic: errors: target must be a non-nil pointer.
O panică înrudită este panic: errors: *target must be interface or implement error: ai dat un pointer, dar la o variabilă al cărei tip nu este o eroare (de exemplu &n cu n int).
Regula: declari o variabilă de tipul exact al erorii căutate (var e *EroareStoc dacă metoda Error are receptor pointer), apoi dai &e. Instrumentul go vet semnalează multe dintre aceste greșeli înainte de rulare.
De ce apare: cauzele frecvente
1Variabila dată fără &
var e *EroareStoc
if errors.As(err, e) {
fmt.Println(e.Produs)
}var e *EroareStoc
if errors.As(err, &e) {
fmt.Println(e.Produs)
}&e este un pointer la variabilă, prin care errors.As poate seta eroarea găsită.
2Țintă de un tip care nu e eroare
var cod int
errors.As(err, &cod)var e *EroareHTTP
if errors.As(err, &e) {
cod := e.Cod
}Mesajul este *target must be interface or implement error. Ținta trebuie să fie de tipul erorii, nu al unui câmp din ea.
3Tip valoare vs tip pointer
var e EroareStoc // Error() are receptor *EroareStoc
errors.As(err, &e)var e *EroareStoc
errors.As(err, &e)Dacă Error() e definită pe *EroareStoc, eroarea din lanț este un *EroareStoc, deci ținta trebuie să fie de același tip.
Repară eroarea, direct în pagină
Programul verifică dacă o comandă a eșuat din cauza stocului, dar dă lui errors.As variabila în loc de adresa ei și se oprește cu panic: errors: target must be a non-nil pointer. Repară apelul ca programul să afișeze Stoc insuficient pentru mouse.
package main
import (
"errors"
"fmt"
)
type EroareStoc struct{ Produs string }
func (e *EroareStoc) Error() string { return "stoc insuficient: " + e.Produs }
func comanda(produs string) error {
return fmt.Errorf("comanda 12: %w", &EroareStoc{Produs: produs})
}
func main() {
err := comanda("mouse")
var e *EroareStoc
if errors.As(err, e) {
fmt.Println("Stoc insuficient pentru", e.Produs)
}
}Stoc insuficient pentru mouse
Indiciu
Al doilea argument al lui errors.As este adresa variabilei: &e.
Reparația
package main
import (
"errors"
"fmt"
)
type EroareStoc struct{ Produs string }
func (e *EroareStoc) Error() string { return "stoc insuficient: " + e.Produs }
func comanda(produs string) error {
return fmt.Errorf("comanda 12: %w", &EroareStoc{Produs: produs})
}
func main() {
err := comanda("mouse")
var e *EroareStoc
if errors.As(err, &e) {
fmt.Println("Stoc insuficient pentru", e.Produs)
}
}De ce merge
e era un pointer nil, deci errors.As nu avea unde să scrie eroarea găsită. Cu &e, funcția primește adresa variabilei, parcurge lanțul (eroarea e împachetată cu %w), găsește *EroareStoc și o pune în e. Apoi poți citi câmpul Produs. Același tipar se aplică oricărui tip de eroare personalizat: declari variabila, apoi îi dai adresa.
Alte forme ale mesajului
panic: errors: *target must be interface or implement errorsecond argument to errors.As must be a non-nil pointer to either a type that implements error, or to any interface type
Cum o eviți pe viitor
Memorează forma: var e *TipEroare; if errors.As(err, &e) { ... }. Rulează go vet (este rulat automat și de go test): analizorul errorsas prinde exact această greșeală. Folosește errors.Is pentru erori sentinelă (ErrNotFound) și errors.As doar când ai nevoie de câmpurile unui tip de eroare.
Întrebări frecvente
Care e diferența dintre errors.Is și errors.As?
errors.Is(err, ErrX) verifică dacă în lanț există o anumită valoare de eroare. errors.As(err, &e) caută o eroare de un anumit tip și ți-o dă, ca să-i poți citi câmpurile.
De ce nu folosesc direct err.(*EroareStoc)?
Aserțiunea verifică doar eroarea de la suprafață. Dacă eroarea a fost împachetată cu fmt.Errorf("...: %w", err), doar errors.As o găsește.
Erori înrudite
panic: interface conversion: interface {} is string, not int Ai făcut o aserțiune de tip x.(int) pe o valoare de tip any care conține de fapt un string. Folosește forma cu două valori, v, ok := x.(int), sau un type switch, și tratează cazul în care tipul nu e cel așteptat. panic: runtime error: invalid memory address or nil pointer dereference Ai folosit un pointer care este nil: ai citit un câmp sau ai apelat o metodă printr-un pointer care nu indică spre nicio valoare. Inițializează pointerul (p := &Produs{} sau un constructor) și verifică if p != nil înainte de folosire, mai ales după funcții care pot întoarce nil. invalid operation: n (variable of type int) is not an interface Aserțiunea de tip x.(T) și type switch-ul merg doar pe valori de tip interfață (any, error, io.Reader...). Dacă variabila are deja un tip concret (int, string, struct), nu ai nevoie de aserțiune: folosește-o direct sau convertește cu T(x). Î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.
