...
Eroare Spring Boot · JSON și Jackson

JSON parse error: Unrecognized token 'Mouse': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false')

Pe scurt

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

Greșit
JAVA
{"nume": Mouse, "pret": 89.9}
Corect
JAVA
{"nume": "Mouse", "pret": 89.9}

Valorile text se scriu între ghilimele duble.

2Cuvinte din alt limbaj

Greșit
JAVA
{"activ": True, "reducere": None}
Corect
JAVA
{"activ": true, "reducere": null}

JSON are doar true, false, null, cu litere mici.

3Corpul nu e JSON

Greșit
JAVA
POST /note
Content-Type: application/json

Livrare după ora 18
Corect
JAVA
POST /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ă tu

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.

Codul care dă eroarea
JAVA
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";
    }
}
După reparație, programul afișează
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.

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/null cu 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

← Toate erorile Spring Boot

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ță 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.