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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În JSON, o valoare poate fi doar: un text între ghilimele duble, un număr, un obiect {...}, un tablou [...] sau unul dintre cuvintele true, false, null. Când Jackson întâlnește alt cuvânt, aruncă JsonParseException: Unrecognized token 'Mouse': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false'). Între ghilimelele simple din mesaj vezi exact cuvântul nerecunoscut.
Cazuri tipice: un text fără ghilimele ("nume": Mouse), True/False/None scrise ca în Python, NaN, sau un corp care nu e JSON (text simplu, un formular, un HTML de eroare primit de la alt serviciu) trimis către o metodă care așteaptă JSON. Când cuvântul din mesaj e începutul unui text obișnuit ('Livrare'), corpul întreg probabil nu era JSON.
De ce apare: cauzele frecvente
1Text fără ghilimele
{"nume": Mouse, "pret": 89.9}{"nume": "Mouse", "pret": 89.9}Valorile text se scriu între ghilimele duble.
2Cuvinte din alt limbaj
{"activ": True, "reducere": None}{"activ": true, "reducere": null}JSON are doar true, false, null, cu litere mici.
3Corpul nu e JSON
POST /note
Content-Type: application/json
Livrare după ora 18POST /note
Content-Type: application/json
{"text": "Livrare după ora 18"}Un text simplu nu este un document JSON, chiar dacă antetul spune că este.
Repară eroarea, direct în pagină
GET /import răspunde 500 cu Unrecognized token: în textul JSON primit de la furnizor, numele produsului nu are ghilimele. Corectează 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
Valorile text din JSON stau între ghilimele duble.
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
Jackson aștepta după "nume": o valoare JSON: text între ghilimele, număr, obiect, tablou sau true/false/null. Cuvântul Mouse fără ghilimele nu e niciuna, deci parsarea s-a oprit cu Unrecognized token. Cu "Mouse", valoarea e un text valid. Mesajul arată cuvântul nerecunoscut, ceea ce te duce direct la locul problemei.
Alte forme ale mesajului
JSON parse error: Unrecognized token 'True': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false')
Cum o eviți pe viitor
- Generează JSON cu biblioteci (
JSON.stringify,ObjectMapper), nu prin lipire de texte. - Când un alt serviciu răspunde cu HTML (de exemplu o pagină de eroare), verifică statusul înainte să parsezi corpul.
- Folosește
true/false/nullcu litere mici. - Loghează primele caractere ale corpului primit când parsarea eșuează, ca să vezi ce a venit de fapt.
Întrebări frecvente
Cum văd ce text a primit serverul?
Activează temporar logging.level.org.springframework.web=DEBUG sau loghează corpul într-un filtru. Primele caractere arată de obicei problema.
Ce înseamnă Unrecognized token '<'?
Corpul începea cu <, adică era HTML sau XML. De cele mai multe ori ai primit o pagină de eroare în loc de JSON.
Erori înrudite
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). 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. Content-Type 'text/plain;charset=UTF-8' is not supported Clientul trimite corpul cu un Content-Type pe care metoda nu îl poate citi (de exemplu text/plain la un @RequestBody care așteaptă JSON), deci Spring răspunde 415 Unsupported Media Type. Trimite antetul Content-Type: application/json sau primește textul ca String. Î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.
