json: unknown field "price"
Ai activat DisallowUnknownFields pe json.Decoder, iar JSON-ul conține o cheie care nu corespunde niciunui câmp din struct (de multe ori o greșeală de nume sau un tag json diferit). Corectează cheia, adaugă câmpul cu tag-ul potrivit, sau renunță la verificarea strictă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Implicit, encoding/json ignoră cheile pe care nu le găsește în struct. Cu dec.DisallowUnknownFields() decodarea devine strictă: prima cheie necunoscută oprește decodarea cu json: unknown field "price". Este util la API-uri și fișiere de configurare, unde o cheie scrisă greșit ("timout" în loc de "timeout") altfel ar trece neobservată, iar câmpul ar rămâne la valoarea zero.
Potrivirea cheilor cu câmpurile se face după tag-ul json:"..." sau, fără tag, după numele câmpului, fără să țină cont de litere mari și mici. Câmpurile neexportate (cu literă mică) nu sunt văzute deloc, deci cheile lor sunt „necunoscute”.
Mesajul îți dă exact cheia; caută-o în JSON și în tag-urile struct-ului.
De ce apare: cauzele frecvente
1Cheia și tag-ul diferă
type Produs struct {
Nume string `json:"nume"`
Pret float64 `json:"pret"`
}
// JSON: {"nume": "Mouse", "price": 49}type Produs struct {
Nume string `json:"nume"`
Pret float64 `json:"price"`
}
// JSON: {"nume": "Mouse", "price": 49}Tag-ul trebuie să fie exact numele cheii din JSON. Alternativ, corectezi cheia la sursă.
2Câmp neexportat
type Config struct {
port int `json:"port"`
}type Config struct {
Port int `json:"port"`
}encoding/json vede doar câmpurile exportate (cu majusculă); port nu poate primi valoarea, deci cheia apare ca necunoscută.
3Câmp nou trimis de client
dec.DisallowUnknownFields()
// clientul a început să trimită "moneda"type Produs struct {
Nume string `json:"nume"`
Pret float64 `json:"pret"`
Moneda string `json:"moneda,omitempty"`
}Dacă cheia este legitimă, adaug-o în struct; dacă vrei toleranță la câmpuri noi, nu activa verificarea strictă.
Repară eroarea, direct în pagină
Serviciul primește produse în JSON și decodează strict, cu DisallowUnknownFields. Clientul trimite prețul sub cheia price, iar struct-ul are tag-ul pret, așa că programul se oprește cu panic: json: unknown field "price". Potrivește tag-ul cu cheia primită ca programul să afișeze Mouse: 49 lei.
package main
import (
"encoding/json"
"fmt"
"strings"
)
type Produs struct {
Nume string `json:"nume"`
Pret float64 `json:"pret"`
}
func main() {
cerere := `{"nume": "Mouse", "price": 49}`
dec := json.NewDecoder(strings.NewReader(cerere))
dec.DisallowUnknownFields()
var p Produs
if err := dec.Decode(&p); err != nil {
panic(err)
}
fmt.Printf("%s: %v lei\n", p.Nume, p.Pret)
}Mouse: 49 lei
Indiciu
Tag-ul câmpului Pret trebuie să fie numele cheii din JSON.
Reparația
package main
import (
"encoding/json"
"fmt"
"strings"
)
type Produs struct {
Nume string `json:"nume"`
Pret float64 `json:"price"`
}
func main() {
cerere := `{"nume": "Mouse", "price": 49}`
dec := json.NewDecoder(strings.NewReader(cerere))
dec.DisallowUnknownFields()
var p Produs
if err := dec.Decode(&p); err != nil {
panic(err)
}
fmt.Printf("%s: %v lei\n", p.Nume, p.Pret)
}De ce merge
Cu verificarea strictă, fiecare cheie din JSON trebuie să corespundă unui câmp prin tag-ul json. Cheia price nu avea niciun câmp, de aceea decodarea s-a oprit; fără verificare, Pret ar fi rămas tăcut 0. Cu tag-ul json:"price", valoarea 49 ajunge în Pret.
Alte forme ale mesajului
json: unknown field "timout"json: unknown field "x"
Cum o eviți pe viitor
Folosește DisallowUnknownFields pentru configurări și cereri de API, unde vrei să afli imediat de chei greșite, și răspunde cu un mesaj clar (codul 400 la un API). Ține tag-urile json explicite pe toate câmpurile, cu un singur stil de nume (snake_case sau camelCase). Testează decodarea cu un exemplu real de JSON primit de la client.
Întrebări frecvente
Merge DisallowUnknownFields și cu json.Unmarshal?
Nu. Opțiunea există doar pe json.Decoder. Pentru un []byte, folosește json.NewDecoder(bytes.NewReader(date)).
De ce fără verificare strictă câmpul rămâne 0?
Pentru că cheia price e ignorată, iar câmpul Pret nu primește nicio valoare, deci păstrează valoarea zero. Programul merge mai departe cu date greșite fără nicio eroare.
Erori înrudite
json: cannot unmarshal string into Go struct field Produs.pret of type float64 Î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. invalid character '{' after top-level value JSON-ul are, după o valoare completă, încă ceva: alt obiect (mai multe obiecte unul după altul, ca în fișierele NDJSON), o acoladă în plus sau text rămas. json.Unmarshal acceptă o singură valoare; pentru mai multe folosește json.NewDecoder și Decode într-o buclă, sau elimină caracterele în plus. json: Unmarshal(non-pointer main.Produs) 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). Î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.
