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

%!s(<nil>)

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Când o directivă de formatare nu se potrivește cu valoarea primită, fmt nu oprește programul, ci scrie un marcaj de forma %!verb(tip=valoare). Pentru nil fără tip (o interfață goală, cum e o error nil sau o variabilă any nil), marcajul este %!s(<nil>), iar pentru un pointer nil cu tip cunoscut, de exemplu %!s(*main.Produs=<nil>). Cu %d vezi %!d(<nil>).

Cel mai des apare în mesaje de log sau de eroare construite indiferent dacă a apărut o eroare: fmt.Sprintf("comanda %d: %s", id, err), unde err e nil în cazul fericit. Uneori apare și în răspunsuri JSON sau în texte afișate utilizatorului, așa că merită căutat în loguri. %v afișează <nil> fără marcaj, dar nici asta nu e un mesaj bun pentru utilizator.

De ce apare: cauzele frecvente

1Mesaj de eroare construit și când nu e eroare

Greșit
GO
err := salveaza(c)
fmt.Printf("comanda %d: %s\n", c.ID, err)
Corect
GO
if err := salveaza(c); err != nil {
	fmt.Printf("comanda %d: %s\n", c.ID, err)
} else {
	fmt.Printf("comanda %d: salvată\n", c.ID)
}

err poate fi nil; tratezi separat cazul de succes și afișezi eroarea doar când există.

2Pointer nil la un struct

Greșit
GO
var p *Produs = cauta("xyz")
fmt.Printf("găsit: %s\n", p)
Corect
GO
if p := cauta("xyz"); p != nil {
	fmt.Printf("găsit: %s\n", p.Nume)
} else {
	fmt.Println("produs inexistent")
}

Verifici rezultatul înainte să îl afișezi și formatezi un câmp concret, nu pointerul.

Repară tu

Repară eroarea, direct în pagină

Funcția mesaj construiește textul pentru fiecare comandă procesată, dar pentru comenzile reușite scrie %!s(<nil>), iar verificarea din main oprește programul. Afișează salvată când nu există eroare și textul erorii altfel, ca programul să afișeze:

comanda 1: salvată
comanda 2: stoc insuficient
comanda 3: salvată
Codul care dă eroarea
GO
package main

import (
	"errors"
	"fmt"
	"strings"
)

func proceseaza(id int) error {
	if id == 2 {
		return errors.New("stoc insuficient")
	}
	return nil
}

func mesaj(id int, err error) string {
	return fmt.Sprintf("comanda %d: %s", id, err)
}

func main() {
	for id := 1; id <= 3; id++ {
		m := mesaj(id, proceseaza(id))
		if strings.Contains(m, "%!") {
			panic("formatare greșită: " + m)
		}
		fmt.Println(m)
	}
}
După reparație, programul afișează
comanda 1: salvată
comanda 2: stoc insuficient
comanda 3: salvată
Indiciu

Verifică if err != nil în mesaj și întoarce două texte diferite.

Alte forme ale mesajului

  • %!s(*main.Produs=<nil>)
  • %!d(<nil>)

Cum o eviți pe viitor

Construiește mesajele de eroare doar în ramura if err != nil. Rulează go vet, care semnalează multe nepotriviri între directive și argumente. Pentru valori care pot lipsi, scrie o funcție mică de afișare (de exemplu textEroare(err) care întoarce "ok" pentru nil). Caută periodic %! în loguri: orice apariție e un bug de formatare.

Întrebări frecvente

De ce fmt nu dă panică la nil?

fmt e gândit să nu oprească programul din cauza formatării, mai ales în loguri. În locul valorii scrie un marcaj care începe cu %!, ca să poți găsi problema.

E la fel cu <nil> afișat de Println?

Nu chiar: fmt.Println(err) scrie <nil> fără marcaj, pentru că Println folosește formatul implicit %v. Marcajul %!s(...) apare doar cu %s (sau alt verb) la o valoare nil fără tip.

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.