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

%!v(PANIC=String method: runtime error: index out of range [0] with length 0)

Pe scurt

Metoda String() (sau Error()) a tipului tău a dat panică în timpul afișării, iar fmt a prins panica și a scris-o în text. Repară metoda ca să meargă și pentru valoarea zero (slice gol, câmpuri goale, pointer nil): verifică lungimea sau nil înainte să accesezi elemente.

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

Ce înseamnă

Când afișezi o valoare cu Println, %v sau %s, fmt cheamă metoda ei String() (sau Error() pentru erori). Dacă metoda dă panică, fmt nu oprește programul: prinde panica și scrie în locul valorii %!v(PANIC=String method: <motiv>). Motivul este panica originală, de exemplu runtime error: index out of range [0] with length 0 sau runtime error: invalid memory address or nil pointer dereference.

Apare aproape mereu pentru valoarea zero a tipului: o comandă fără produse, un struct creat cu Comanda{}, un câmp slice sau map neinițializat. Metoda a fost scrisă gândindu-te doar la cazul „plin”. Partea neplăcută e că programul merge mai departe, iar marcajul ajunge în loguri sau în texte afișate utilizatorului.

De ce apare: cauzele frecvente

1Primul element accesat fără verificare

Greșit
GO
func (c Comanda) String() string {
	return c.Produse[0] + " și altele"
}
Corect
GO
func (c Comanda) String() string {
	if len(c.Produse) == 0 {
		return "comandă goală"
	}
	return c.Produse[0] + " și altele"
}

Valoarea zero are slice-ul gol; metoda tratează explicit cazul ăsta.

2Câmp pointer nil folosit în String

Greșit
GO
func (c Comanda) String() string {
	return c.Client.Nume
}
Corect
GO
func (c Comanda) String() string {
	if c.Client == nil {
		return "fără client"
	}
	return c.Client.Nume
}

Câmpul Client *Client e nil până îl setezi; verificarea evită dereferențierea.

Repară tu

Repară eroarea, direct în pagină

Metoda String a tipului Comanda afișează primul produs și câte mai sunt, dar dă panică pentru o comandă goală, iar fmt scrie %!v(PANIC=String method: ...). Verificarea din main oprește programul. Tratează comanda fără produse, ca programul să afișeze:

Comanda 1: mouse + 2 produse
Comanda 2: goală
Codul care dă eroarea
GO
package main

import (
	"fmt"
	"strings"
)

type Comanda struct {
	ID      int
	Produse []string
}

func (c Comanda) String() string {
	return fmt.Sprintf("Comanda %d: %s + %d produse", c.ID, c.Produse[0], len(c.Produse)-1)
}

func main() {
	comenzi := []Comanda{{1, []string{"mouse", "cablu", "husa"}}, {ID: 2}}
	for _, c := range comenzi {
		s := fmt.Sprint(c)
		if strings.Contains(s, "PANIC=") {
			panic(s)
		}
		fmt.Println(s)
	}
}
După reparație, programul afișează
Comanda 1: mouse + 2 produse
Comanda 2: goală
Indiciu

Verifică len(c.Produse) == 0 înainte de c.Produse[0].

Alte forme ale mesajului

  • %!v(PANIC=String method: runtime error: invalid memory address or nil pointer dereference)
  • %!s(PANIC=String method: runtime error: index out of range [0] with length 0)
  • %!v(PANIC=Error method: runtime error: invalid memory address or nil pointer dereference)

Cum o eviți pe viitor

Scrie metodele String() și Error() astfel încât să meargă pentru orice valoare, inclusiv T{} și (la receiver pointer) nil. Ține-le simple: doar formatare, fără calcule care pot eșua. Testează-le explicit cu valoarea zero. Caută PANIC= în loguri: e semnul unei metode de afișare stricate.

Întrebări frecvente

De ce programul nu s-a oprit, deși e o panică?

fmt prinde intenționat panicile din String, Error și Format, ca o greșeală de afișare să nu oprească tot programul. Excepție: pentru un receiver pointer nil, fmt afișează direct <nil>.

Cum aflu unde e exact problema?

Cheamă metoda direct, c.String(), într-un test sau în main: atunci panica nu mai e prinsă și primești stiva completă, cu linia din metodă.

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.