...
Eroare Go · strconv și JSON

json: Unmarshal(non-pointer main.Produs)

Pe scurt

Ai trimis la json.Unmarshal variabila însăși (p), nu adresa ei (&p). Unmarshal are nevoie de un pointer ca să poată scrie datele în variabila ta. Scrie json.Unmarshal(data, &p).

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

Ce înseamnă

json.Unmarshal(data, v) completează valoarea v cu datele din JSON. În Go argumentele se transmit prin copie, deci dacă trimiți p, funcția ar completa doar o copie, iar variabila ta ar rămâne goală. Ca să evite această greșeală tăcută, Unmarshal verifică argumentul și întoarce eroarea json: Unmarshal(non-pointer main.Produs), unde main.Produs este tipul pe care l-ai trimis.

Variantă: json: Unmarshal(nil) sau json: Unmarshal(nil *main.Produs) când trimiți nil sau un pointer nil (de exemplu var p *Produs fără să-l inițializezi).

Aceeași regulă e valabilă pentru json.NewDecoder(r).Decode(&p) și pentru alte funcții care completează date (fmt.Sscan, errors.As).

De ce apare: cauzele frecvente

1Variabila trimisă fără &

Greșit
GO
var p Produs
err := json.Unmarshal(data, p)
Corect
GO
var p Produs
err := json.Unmarshal(data, &p)

&p este adresa variabilei: Unmarshal scrie direct în ea.

2Pointer declarat, dar nil

Greșit
GO
var p *Produs
err := json.Unmarshal(data, p)
Corect
GO
p := &Produs{}
err := json.Unmarshal(data, p)

Un pointer nil nu indică spre nicio valoare în care să se scrie; mesajul este json: Unmarshal(nil *main.Produs). &Produs{} creează valoarea.

Repară tu

Repară eroarea, direct în pagină

Programul citește un utilizator dintr-un JSON, dar se oprește cu panic: json: Unmarshal(non-pointer main.Utilizator). Repară apelul ca programul să afișeze Ana are 3 cursuri.

Codul care dă eroarea
GO
package main

import (
	"encoding/json"
	"fmt"
)

type Utilizator struct {
	Nume    string   `json:"nume"`
	Cursuri []string `json:"cursuri"`
}

func main() {
	data := []byte(`{"nume": "Ana", "cursuri": ["Go", "SQL", "Git"]}`)
	var u Utilizator
	if err := json.Unmarshal(data, u); err != nil {
		panic(err)
	}
	fmt.Printf("%s are %d cursuri\n", u.Nume, len(u.Cursuri))
}
După reparație, programul afișează
Ana are 3 cursuri
Indiciu

Unmarshal trebuie să primească adresa variabilei: &u.

Alte forme ale mesajului

  • json: Unmarshal(nil *main.Produs)
  • json: Unmarshal(nil)
  • json: Unmarshal(non-pointer []main.Produs)

Cum o eviți pe viitor

Reține tiparul: funcțiile care completează o valoare primesc adresa ei (json.Unmarshal(data, &v), dec.Decode(&v)), iar cele care doar citesc o valoare o primesc direct (json.Marshal(v)). Verifică întotdeauna eroarea întoarsă de Unmarshal: fără verificare, greșeala aceasta trece neobservată și variabila rămâne goală.

Întrebări frecvente

De ce json.Marshal nu cere pointer, iar Unmarshal da?

Marshal doar citește valoarea ca s-o transforme în text, deci o copie îi ajunge. Unmarshal trebuie să modifice variabila ta, deci are nevoie de adresa ei.

La slice-uri și map-uri trebuie tot &?

Da: json.Unmarshal(data, &produse). Funcția poate avea nevoie să creeze un slice sau un map nou, iar fără pointer nu ar avea cum să ți-l dea înapoi.

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.