...
Eroare Go · Panici la rulare

panic: errors: target must be a non-nil pointer

Pe scurt

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ă &

Greșit
GO
var e *EroareStoc
if errors.As(err, e) {
	fmt.Println(e.Produs)
}
Corect
GO
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

Greșit
GO
var cod int
errors.As(err, &cod)
Corect
GO
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

Greșit
GO
var e EroareStoc // Error() are receptor *EroareStoc
errors.As(err, &e)
Corect
GO
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ă tu

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.

Codul care dă eroarea
GO
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)
	}
}
După reparație, programul afișează
Stoc insuficient pentru mouse
Indiciu

Al doilea argument al lui errors.As este adresa variabilei: &e.

Alte forme ale mesajului

  • panic: errors: *target must be interface or implement error
  • second 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

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