...
Eroare Go · strconv și JSON

json: unknown field "price"

Pe scurt

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ă

Greșit
GO
type Produs struct {
	Nume string  `json:"nume"`
	Pret float64 `json:"pret"`
}
// JSON: {"nume": "Mouse", "price": 49}
Corect
GO
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

Greșit
GO
type Config struct {
	port int `json:"port"`
}
Corect
GO
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

Greșit
GO
dec.DisallowUnknownFields()
// clientul a început să trimită "moneda"
Corect
GO
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ă tu

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.

Codul care dă eroarea
GO
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)
}
După reparație, programul afișează
Mouse: 49 lei
Indiciu

Tag-ul câmpului Pret trebuie să fie numele cheii din JSON.

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

← 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.