...
Eroare Go · strconv și JSON

invalid character '{' after top-level value

Pe scurt

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.

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

Ce înseamnă

json.Unmarshal citește o singură valoare JSON (un obiect, o listă, un număr...) și verifică apoi că după ea nu mai urmează decât spații. Dacă după valoarea completă mai apare un caracter, primești invalid character '{' after top-level value, unde caracterul din ghilimele este primul lucru în plus.

Cazuri frecvente:

  • '{': mai multe obiecte unul după altul (loguri, exporturi NDJSON, răspunsuri lipite);
  • '}' sau ']': o paranteză închisă de două ori;
  • o literă: text adăugat după JSON (de exemplu un mesaj de log sau un \n urmat de altceva).

json.Decoder citește valori una câte una din același flux, deci e unealta potrivită pentru mai multe obiecte.

De ce apare: cauzele frecvente

1Mai multe obiecte în același text

Greșit
GO
date := `{"id": 1} {"id": 2}`
var c Comanda
err := json.Unmarshal([]byte(date), &c)
Corect
GO
dec := json.NewDecoder(strings.NewReader(date))
for {
	var c Comanda
	if err := dec.Decode(&c); err == io.EOF {
		break
	} else if err != nil {
		return err
	}
	fmt.Println(c.ID)
}

Decoder citește câte un obiect la fiecare Decode și întoarce io.EOF după ultimul.

2Acoladă în plus

Greșit
GO
date := `{"nume": "Ana", "varsta": 30}}`
Corect
GO
date := `{"nume": "Ana", "varsta": 30}`

Obiectul se termină la prima } care îl închide; a doua este „după valoare” și e respinsă.

Repară tu

Repară eroarea, direct în pagină

Programul citește comenzile dintr-un export în care fiecare comandă e un obiect JSON separat, dar folosește json.Unmarshal pe tot textul și se oprește cu panic: invalid character '{' after top-level value. Citește obiectele unul câte unul ca programul să afișeze Comenzi: 3, total: 245.

Codul care dă eroarea
GO
package main

import (
	"encoding/json"
	"fmt"
)

type Comanda struct {
	ID    int `json:"id"`
	Total int `json:"total"`
}

func main() {
	date := `{"id": 1, "total": 100}
{"id": 2, "total": 45}
{"id": 3, "total": 100}`
	var c Comanda
	if err := json.Unmarshal([]byte(date), &c); err != nil {
		panic(err)
	}
	fmt.Println(c)
}
După reparație, programul afișează
Comenzi: 3, total: 245
Indiciu

json.NewDecoder(strings.NewReader(date)) și Decode într-o buclă până la io.EOF.

Alte forme ale mesajului

  • invalid character '}' after top-level value
  • invalid character ']' after top-level value
  • invalid character 'x' after top-level value
  • invalid character '"' after top-level value

Cum o eviți pe viitor

Când primești date de la alt sistem, află formatul exact: un singur document JSON, o listă [...] sau un obiect pe linie (NDJSON). Pentru fluxuri (fișiere mari, răspunsuri HTTP) folosește json.NewDecoder(r), care nu are nevoie să încarce totul în memorie. Afișează în mesajul de eroare primele caractere din date, ca să vezi rapid ce e în plus.

Întrebări frecvente

De ce json.NewDecoder(...).Decode nu dă eroarea asta?

Pentru că Decode citește doar prima valoare și lasă restul fluxului pentru următorul apel. Dacă vrei să verifici că nu mai urmează nimic, apelează dec.More() sau încă un Decode și așteaptă io.EOF.

Ce e NDJSON?

Un format în care fiecare linie este un obiect JSON separat (folosit des la loguri și exporturi). Se citește cu json.Decoder sau linie cu linie cu bufio.Scanner și json.Unmarshal pe fiecare linie.

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.