...
Eroare Go · fmt, CSV, XML și template-uri

%!w(*errors.errorString=&{fișier lipsă})

Pe scurt

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

Greșit
GO
return errors.New(fmt.Sprintf("citire config: %w", err))
Corect
GO
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

Greșit
GO
log.Printf("eroare la plată: %w", err)
Corect
GO
log.Printf("eroare la plată: %v", err)

La afișare nu împachetezi nimic; %v (sau %s) scrie textul erorii.

Repară tu

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ă
Codul care dă eroarea
GO
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ă")
}
După reparație, programul afișează
citeste config.json: fișier lipsă
folosesc configurarea implicită
Indiciu

fmt.Errorf("citește %s: %w", nume, ErrLipsa) creează direct eroarea împachetată.

Alte forme ale mesajului

  • %!w(<nil>)
  • fmt.Sprintf does not support error-wrapping directive %w
  • fmt.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

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