JSON parse error: Unexpected character ('}' (code 125)): was expecting double-quote to start field name
JSON-ul primit nu este valid: Jackson a găsit un caracter care nu are voie să fie acolo, cel mai des o virgulă înainte de } sau ]. Corectează textul JSON (fără virgulă finală, cheile între ghilimele duble).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Jackson citește JSON-ul caracter cu caracter. După o virgulă, într-un obiect, se așteaptă la numele următorului câmp, între ghilimele duble. Dacă găsește altceva, de exemplu }, aruncă JsonParseException: Unexpected character ('}' (code 125)): was expecting double-quote to start field name. (code 125) este codul caracterului, iar finalul mesajului spune ce aștepta.
Într-un controller, eroarea apare ca HttpMessageNotReadableException: JSON parse error: ... și clientul primește 400. Când parsezi singur (objectMapper.readValue), primești excepția direct, cu poziția: line: 1, column: 31.
Cauze tipice, venite din JavaScript sau din scrierea manuală: virgula după ultimul câmp ({"a": 1,}), chei fără ghilimele ({nume: "Ana"}), ghilimele simple ({'nume': 'Ana'}) sau comentarii. JSON-ul standard nu acceptă niciuna.
De ce apare: cauzele frecvente
1Virgulă după ultimul câmp
{"nume": "Mouse", "pret": 89.9,}{"nume": "Mouse", "pret": 89.9}În JSON, după ultima pereche nu urmează virgulă.
2Chei fără ghilimele duble
{nume: "Mouse", 'pret': 89.9}{"nume": "Mouse", "pret": 89.9}Cheile sunt texte JSON: doar între ghilimele duble.
Repară eroarea, direct în pagină
Ruta GET /import citește un produs trimis de un furnizor, dar răspunde 500 cu Unexpected character, pentru că textul JSON are o virgulă după ultimul câmp. Corectează textul din constanta JSON, ca ruta să răspundă Importat: Mouse, 89.9 lei.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.math.BigDecimal;
import java.time.LocalDate;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Produs(String nume, double pret) {
}
@RestController
class ImportController {
// textul primit de la furnizor (în aplicația reală vine dintr-un fișier sau dintr-un API)
static final String JSON = """
{"nume": "Mouse", "pret": 89.9,}
""";
private final ObjectMapper mapper;
ImportController(ObjectMapper mapper) {
this.mapper = mapper;
}
@GetMapping("/import")
String importa() throws Exception {
Produs p = mapper.readValue(JSON, Produs.class);
return "Importat: " + p.nume() + ", " + p.pret() + " lei";
}
}Tomcat started on port 8080 (http) Started Application GET /import → 200 Importat: Mouse, 89.9 lei
Indiciu
În JSON, după ultima pereche cheie-valoare nu urmează virgulă.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.math.BigDecimal;
import java.time.LocalDate;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Produs(String nume, double pret) {
}
@RestController
class ImportController {
// textul primit de la furnizor (în aplicația reală vine dintr-un fișier sau dintr-un API)
static final String JSON = """
{"nume": "Mouse", "pret": 89.9}
""";
private final ObjectMapper mapper;
ImportController(ObjectMapper mapper) {
this.mapper = mapper;
}
@GetMapping("/import")
String importa() throws Exception {
Produs p = mapper.readValue(JSON, Produs.class);
return "Importat: " + p.nume() + ", " + p.pret() + " lei";
}
}De ce merge
Parserul JSON ajunsese după virgula de la final și aștepta numele unui câmp nou, între ghilimele, dar a găsit }. JSON-ul standard nu permite virgula finală, chiar dacă JavaScript o acceptă în obiecte. Fără ea, textul e valid, Jackson creează record-ul Produs, iar ruta răspunde. Când datele vin de la un client prin @RequestBody, aceeași greșeală dă 400, iar reparația se face la client.
Alte forme ale mesajului
JSON parse error: Unexpected character (''' (code 39)): was expecting double-quote to start field nameJSON parse error: Unexpected character ('n' (code 110)): was expecting double-quote to start field name
Cum o eviți pe viitor
- Nu construi JSON prin concatenare de texte; folosește
ObjectMapper.writeValueAsStringsauJSON.stringifyîn client. - Validează fișierele JSON în editor (VS Code, IntelliJ subliniază virgula finală).
- Când primești JSON de la parteneri, loghează textul primit la erori, ca să vezi exact caracterul problematic.
- Testează și cu un JSON stricat, ca să vezi ce răspuns primește clientul.
Întrebări frecvente
De ce JavaScript acceptă virgula finală?
Obiectele JavaScript o acceptă, dar JSON nu. JSON.stringify nu o pune niciodată; apare doar când scrii JSON de mână.
Pot face Jackson să accepte virgula finală?
Da, cu JsonReadFeature.ALLOW_TRAILING_COMMA, dar e mai sănătos să repari sursa datelor.
Erori înrudite
JSON parse error: Unrecognized token 'Mouse': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false') Jackson a găsit un cuvânt care nu e o valoare JSON validă, de obicei un text fără ghilimele (Mouse în loc de "Mouse") sau un corp care nu e JSON deloc. Pune textele între ghilimele duble și trimite JSON valid. JSON parse error: Unexpected end-of-input: expected close marker for Object Textul JSON se termină înainte ca obiectul sau tabloul să fie închis: lipsește } sau ], ori corpul a fost tăiat. Verifică parantezele și dacă ai trimis tot conținutul. Required request body is missing Metoda are un parametru @RequestBody, dar cererea a venit fără corp (adesea datele erau în query sau cererea era GET), deci Spring răspunde 400. Trimite JSON-ul în corpul cererii sau citește datele cu @RequestParam dacă vin în adresă. Învață Spring Boot de la zero, cu exerciții la fiecare lecție
Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.
