%!w(*errors.errorString=&{fișier lipsă})
Directiva %w funcționează doar în fmt.Errorf. În Sprintf, Printf sau errors.New(fmt.Sprintf(...)) apare %!w(...) în text, iar eroarea originală nu mai e împachetată (errors.Is nu o mai găsește). Folosește fmt.Errorf("context: %w", err) pentru împachetare și %v pentru simpla afișare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
%w (wrap) îi spune lui fmt.Errorf să păstreze eroarea originală în interiorul celei noi, ca errors.Is și errors.As să o poată găsi. Celelalte funcții din fmt (Sprintf, Printf, Println) nu cunosc acest verb, așa că scriu marcajul %!w(tip=valoare): de exemplu %!w(*errors.errorString=&{fișier lipsă}), unde vezi tipul intern al erorii și conținutul ei.
Problema e dublă: mesajul arată urât în loguri și, mai grav, dacă ai construit eroarea cu errors.New(fmt.Sprintf("... %w", err)), lanțul de erori s-a rupt, deci errors.Is(err, ErrLipsa) întoarce false și ramura de tratare specială nu mai rulează. go vet semnalează acest caz cu un mesaj ca fmt.Sprintf does not support error-wrapping directive %w.
De ce apare: cauzele frecvente
1Eroare construită cu errors.New și Sprintf
return errors.New(fmt.Sprintf("citire config: %w", err))return fmt.Errorf("citire config: %w", err)fmt.Errorf cu %w creează o eroare care o conține pe cea originală, deci errors.Is o găsește.
2%w folosit la afișare
log.Printf("eroare la plată: %w", err)log.Printf("eroare la plată: %v", err)La afișare nu împachetezi nimic; %v (sau %s) scrie textul erorii.
Repară eroarea, direct în pagină
Funcția incarca adaugă context erorii, dar o construiește cu errors.New(fmt.Sprintf(...%w...)). Mesajul conține %!w(*errors.errorString=&{fișier lipsă}), iar errors.Is nu mai recunoaște ErrLipsa, așa că programul se oprește. Împachetează eroarea corect, ca programul să afișeze:
citeste config.json: fișier lipsă
folosesc configurarea implicităpackage main
import (
"errors"
"fmt"
)
var ErrLipsa = errors.New("fișier lipsă")
func incarca(nume string) error {
return errors.New(fmt.Sprintf("citeste %s: %w", nume, ErrLipsa))
}
func main() {
err := incarca("config.json")
fmt.Println(err)
if !errors.Is(err, ErrLipsa) {
panic("errors.Is nu recunoaște ErrLipsa: " + err.Error())
}
fmt.Println("folosesc configurarea implicită")
}citeste config.json: fișier lipsă folosesc configurarea implicită
Indiciu
fmt.Errorf("citește %s: %w", nume, ErrLipsa) creează direct eroarea împachetată.
Reparația
package main
import (
"errors"
"fmt"
)
var ErrLipsa = errors.New("fișier lipsă")
func incarca(nume string) error {
return fmt.Errorf("citeste %s: %w", nume, ErrLipsa)
}
func main() {
err := incarca("config.json")
fmt.Println(err)
if !errors.Is(err, ErrLipsa) {
panic("errors.Is nu recunoaște ErrLipsa: " + err.Error())
}
fmt.Println("folosesc configurarea implicită")
}De ce merge
fmt.Sprintf nu știe ce e %w, așa că scria marcajul %!w(...), iar errors.New crea o eroare nouă, fără nicio legătură cu ErrLipsa. fmt.Errorf cu %w produce același text, dar păstrează ErrLipsa în interior, deci errors.Is o găsește și programul trece la configurarea implicită.
Alte forme ale mesajului
%!w(<nil>)fmt.Sprintf does not support error-wrapping directive %wfmt.Printf does not support error-wrapping directive %w
Cum o eviți pe viitor
Reține regula: %w doar în fmt.Errorf, iar pentru afișare %v. Rulează go vet ./... (sau lasă editorul să ruleze analiza) ca să prinzi %w în locuri greșite. Testează ramurile care depind de errors.Is/errors.As cu o eroare împachetată, nu doar cu eroarea originală. Nu construi erori cu errors.New(fmt.Sprintf(...)): fmt.Errorf face același lucru mai scurt.
Întrebări frecvente
Care e diferența dintre %w și %v în fmt.Errorf?
Ambele pun textul erorii în mesaj. Doar %w păstrează și eroarea originală, accesibilă prin errors.Unwrap, errors.Is și errors.As. Cu %v, lanțul se oprește acolo.
Pot folosi mai mulți %w în același Errorf?
Da, de la Go 1.20: fmt.Errorf("%w; %w", e1, e2) împachetează ambele erori, iar errors.Is le găsește pe fiecare.
Erori înrudite
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). %!d(string=00042) Nu e o eroare de compilare, ci textul pe care fmt îl pune în rezultat când verbul nu se potrivește cu tipul: %d (număr întreg) a primit un string. Folosește verbul potrivit tipului (%s pentru string, %d pentru int, %v pentru orice) sau convertește valoarea. %!s(<nil>) Ai dat lui Printf/Sprintf o valoare nil (de obicei o eroare nil sau un pointer nil) pentru %s. fmt nu dă panică, ci scrie %!s(<nil>) în text. Verifică err != nil înainte să construiești mesajul de eroare sau tratează separat cazul nil. Î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.
