...
Eroare Go · strconv și JSON

json: cannot unmarshal string into Go struct field Produs.pret of type float64

Pe scurt

În JSON câmpul pret este un text ("12.5"), dar în struct l-ai declarat float64. Fie corectezi JSON-ul să trimită număr (12.5), fie adaugi opțiunea ,string în tag (json:"pret,string"), fie declari câmpul string și îl convertești tu.

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

Ce înseamnă

Mesajul spune exact ce a găsit json.Unmarshal în date (string), în ce câmp (Produs.pret, adică struct-ul și numele din JSON) și ce tip are câmpul în Go (float64). Decodarea se oprește și întoarce eroarea; câmpurile decodate până atunci rămân completate.

Combinația cea mai des întâlnită este număr trimis ca text ("pret": "12.5"), dar există și inversele: cannot unmarshal number into Go struct field Produs.nume of type string, sau cannot unmarshal array into Go value of type main.Produs când JSON-ul are o listă ([...]) și tu decodezi într-un singur struct.

Citește mesajul de la coadă: tipul din Go, apoi tipul din JSON, și alege care dintre ele trebuie schimbat.

De ce apare: cauzele frecvente

1Număr trimis ca text

Greșit
GO
type Produs struct {
	Pret float64 `json:"pret"`
}

data := `{"pret": "12.5"}`
Corect
GO
type Produs struct {
	Pret float64 `json:"pret,string"`
}

data := `{"pret": "12.5"}`

Opțiunea ,string îi spune decodorului că numărul vine între ghilimele. Dacă poți, mai curat e ca JSON-ul să trimită 12.5 fără ghilimele.

2Listă decodată într-un singur struct

Greșit
GO
var p Produs
err := json.Unmarshal([]byte(`[{"pret": 5}]`), &p)
Corect
GO
var ps []Produs
err := json.Unmarshal([]byte(`[{"pret": 5}]`), &ps)

Un JSON care începe cu [ este o listă și trebuie decodat într-un slice. Mesajul ar fi cannot unmarshal array into Go value of type main.Produs.

3Tipul din Go nu se potrivește cu datele

Greșit
GO
type Client struct {
	Telefon int `json:"telefon"`
}

data := `{"telefon": "0722 000 000"}`
Corect
GO
type Client struct {
	Telefon string `json:"telefon"`
}

data := `{"telefon": "0722 000 000"}`

Un număr de telefon cu spații și zerouri la început e de fapt text. Câmpul potrivit este string.

Repară tu

Repară eroarea, direct în pagină

Programul decodează un produs dintr-un JSON în care prețul vine ca text, dar se oprește cu panic: json: cannot unmarshal string into Go struct field Produs.pret of type float64. Fără să schimbi JSON-ul, repară tag-ul câmpului ca programul să afișeze Mouse: 79.90 lei.

Codul care dă eroarea
GO
package main

import (
	"encoding/json"
	"fmt"
)

type Produs struct {
	Nume string  `json:"nume"`
	Pret float64 `json:"pret"`
}

func main() {
	data := []byte(`{"nume": "Mouse", "pret": "79.90"}`)
	var p Produs
	if err := json.Unmarshal(data, &p); err != nil {
		panic(err)
	}
	fmt.Printf("%s: %.2f lei\n", p.Nume, p.Pret)
}
După reparație, programul afișează
Mouse: 79.90 lei
Indiciu

Adaugă opțiunea ,string în tag-ul câmpului Pret.

Alte forme ale mesajului

  • json: cannot unmarshal number into Go struct field Produs.nume of type string
  • json: cannot unmarshal array into Go value of type main.Produs
  • json: cannot unmarshal object into Go value of type []main.Produs

Cum o eviți pe viitor

Scrie struct-urile după un exemplu real de JSON și alege tipurile după ce conține efectiv fiecare câmp, nu după ce ar trebui să conțină. Verifică întotdeauna eroarea lui json.Unmarshal. Pentru API-uri care trimit numere ca text folosește ,string în tag. Pentru JSON care începe cu [, decodează într-un slice.

Întrebări frecvente

De ce numele din mesaj e cu literă mică (Produs.pret)?

Mesajul folosește numele din JSON (din tag-ul json:"pret"), nu numele câmpului din Go (Pret), ca să găsești ușor locul în date.

Se mai decodează restul câmpurilor după eroare?

Pentru o nepotrivire de tip, Unmarshal continuă cu celelalte câmpuri și întoarce prima eroare de acest tip la final. La o eroare de sintaxă JSON nu se decodează nimic.

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.