...
Eroare Go · Panici la rulare

runtime: goroutine stack exceeds 1000000000-byte limit

Pe scurt

O funcție se apelează pe ea însăși la nesfârșit (recursivitate fără caz de oprire sau cu un caz care nu e atins niciodată), iar stiva goroutinei a depășit limita. Adaugă sau repară condiția de oprire, ori verifică metodele String() / MarshalJSON care se apelează singure.

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

Ce înseamnă

Fiecare apel de funcție ocupă loc pe stiva goroutinei. Stiva din Go crește automat, dar are o limită (implicit 1 GB pe sistemele pe 64 de biți). Când o recursivitate nu se mai oprește, limita e depășită și programul se oprește cu două rânduri: runtime: goroutine stack exceeds 1000000000-byte limit și fatal error: stack overflow. Este o eroare fatală, nu o panică, deci nu poate fi prinsă cu recover.

Sub mesaj urmează o stivă de apeluri foarte lungă, cu aceeași funcție repetată (main.fact(...)) și ...additional frames elided.... Numele care se repetă îți arată funcția vinovată.

Cauze tipice: lipsește cazul de bază, cazul de bază nu e atins (de exemplu n == 0 pentru un n negativ), sau o metodă String() care formatează receiver-ul cu %v și astfel se apelează singură.

De ce apare: cauzele frecvente

1Recursivitate fără caz de bază

Greșit
GO
func fact(n int) int {
	return n * fact(n-1)
}
Corect
GO
func fact(n int) int {
	if n <= 1 {
		return 1
	}
	return n * fact(n-1)
}

Condiția n <= 1 oprește apelurile; <= acoperă și valorile 0 sau negative.

2String() care se apelează singură

Greșit
GO
func (p Produs) String() string {
	return fmt.Sprintf("Produs: %v", p)
}
Corect
GO
func (p Produs) String() string {
	return fmt.Sprintf("Produs: %s (%d lei)", p.Nume, p.Pret)
}

%v pe un tip cu metoda String apelează din nou String; formatează câmpurile, nu receiver-ul.

3Metodă care se apelează în loc de câmp

Greșit
GO
func (c *Cont) Sold() int {
	return c.Sold()
}
Corect
GO
func (c *Cont) Sold() int {
	return c.sold
}

Getter-ul trebuie să citească câmpul (sold), nu să se apeleze pe el însuși.

Repară tu

Repară eroarea, direct în pagină

Funcția recursivă suma adună numerele de la 1 la n, dar nu are caz de oprire, iar programul se oprește cu goroutine stack exceeds ...-byte limit și fatal error: stack overflow (limita stivei e micșorată în cod ca eroarea să apară repede). Adaugă cazul de bază, ca programul să afișeze:

15
5050
Codul care dă eroarea
GO
package main

import (
	"fmt"
	"runtime/debug"
)

func suma(n int) int {
	return n + suma(n-1)
}

func main() {
	debug.SetMaxStack(1 << 20) // limită mică, ca eroarea să apară repede
	fmt.Println(suma(5))
	fmt.Println(suma(100))
}
După reparație, programul afișează
15
5050
Indiciu

Dacă n <= 0, întoarce 0.

Alte forme ale mesajului

  • fatal error: stack overflow
  • runtime: goroutine stack exceeds 1048576-byte limit
  • runtime: goroutine stack exceeds 1000000000-byte limit runtime: sp=0xc020160398 stack=[0xc020160000, 0xc040160000] fatal error: stack overflow

Cum o eviți pe viitor

La orice funcție recursivă scrie întâi cazul de bază și verifică-l cu valori la limită (0, 1, negative, listă goală). Pentru date foarte adânci (liste lungi, arbori degenerați) folosește o buclă cu o stivă proprie ([]Nod). În metodele String() formatează doar câmpurile.

Întrebări frecvente

Pot prinde stack overflow cu recover?

Nu. Este o eroare fatală a runtime-ului, care oprește programul imediat. Singura soluție este să repari recursivitatea.

Pot mări limita stivei?

Da, cu debug.SetMaxStack, dar aproape niciodată nu e soluția: o recursivitate infinită va depăși orice limită. Mărirea are sens doar pentru o recursivitate corectă, dar foarte adâncă.

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.