...
Eroare Spring Boot · JSON și Jackson

JSON parse error: Cannot deserialize value of type `java.lang.String` from Object value (token `JsonToken.START_OBJECT`)

Pe scurt

În JSON-ul primit, un câmp vine ca obiect ({...}), dar în clasa Java este declarat String. Jackson nu poate pune un obiect într-un text, așa că cererea primește 400. Creează un tip pentru acel obiect (de exemplu record Adresa) sau trimite câmpul ca text.

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

Ce înseamnă

Mesajul spune că Jackson trebuia să citească o valoare de tip java.lang.String, dar în JSON a găsit începutul unui obiect: tokenul START_OBJECT, adică {. Asta înseamnă că forma JSON-ului nu se potrivește cu forma clasei în care îl citești.

Cazul tipic: clientul trimite "adresa": {"oras": "Cluj", "strada": "..."}, iar în DTO ai String adresa. Spring transformă eroarea în HttpMessageNotReadableException și răspunde 400 Bad Request, fără să intre în metoda controller-ului.

În jurnal mesajul continuă cu lanțul de câmpuri, de exemplu (through reference chain: ComandaNoua["adresa"]). Acolo vezi exact ce câmp are altă formă. Verifică apoi JSON-ul trimis (în Postman sau în aplicația client) și decide care parte trebuie schimbată: modelul Java sau clientul.

De ce apare: cauzele frecvente

1Câmpul este obiect în JSON, dar String în Java

Greșit
JAVA
record ComandaNoua(String client, String adresa) { }
// {"client": "Ana", "adresa": {"oras": "Cluj"}}
Corect
JAVA
record Adresa(String oras, String strada) { }
record ComandaNoua(String client, Adresa adresa) { }

Fiecare obiect JSON imbricat are nevoie de un tip Java cu aceleași câmpuri.

2Clientul trimite un obiect acolo unde API-ul cere text

Greșit
JAVA
{"nume": "Mouse", "categorie": {"id": 3}}
Corect
JAVA
{"nume": "Mouse", "categorie": "Periferice"}

Dacă contractul API spune că categorie este text, clientul trebuie să trimită text, nu obiectul întreg.

3Vrei să păstrezi JSON-ul brut

Greșit
JAVA
record Eveniment(String tip, String date) { }
Corect
JAVA
record Eveniment(String tip, JsonNode date) { }

JsonNode (sau Map<String, Object>) acceptă orice obiect JSON, util când structura variază.

Repară tu

Repară eroarea, direct în pagină

POST /comenzi primește 400 cu Cannot deserialize value of type java.lang.String from Object value: aplicația mobilă trimite adresa ca obiect (oras, strada). Modelează adresa ca tip separat, ca răspunsul să fie Comanda pentru Ana, livrare în Cluj.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

// TODO: adresa vine din aplicația mobilă ca obiect: {"oras": "...", "strada": "..."}
record ComandaNoua(String client, String adresa) { }

@RestController
class ComandaController {
    @PostMapping("/comenzi")
    String plaseaza(@RequestBody ComandaNoua c) {
        // TODO: afișează orașul din adresă
        return "Comanda pentru " + c.client() + ", livrare: " + c.adresa();
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
POST /comenzi → 200
Comanda pentru Ana, livrare în Cluj
Indiciu

Un obiect JSON imbricat devine un record Java cu aceleași câmpuri.

Alte forme ale mesajului

  • JSON parse error: Cannot deserialize value of type `java.lang.String` from Object value (token `JsonToken.START_OBJECT`)
  • MismatchedInputException: Cannot deserialize value of type `java.lang.String` from Object value (token `JsonToken.START_OBJECT`)
  • Cannot deserialize value of type `java.lang.String` from Array value (token `JsonToken.START_ARRAY`)

Cum o eviți pe viitor

  • Scrie DTO-urile pornind de la un exemplu real de JSON: fiecare {...} devine un record, fiecare [...] o listă.
  • Documentează contractul API (OpenAPI) ca clientul și serverul să folosească aceeași formă.
  • Scrie un test MockMvc cu un corp JSON complet, nu doar cu câmpurile simple.
  • Activează server.error.include-message=always doar în dezvoltare, ca să vezi mesajul în răspuns.

Întrebări frecvente

De ce primesc 400 și metoda mea nu se execută deloc?

Citirea corpului are loc înainte de apelul metodei. Dacă JSON-ul nu se potrivește cu tipul parametrului @RequestBody, Spring răspunde 400 imediat.

Pot citi obiectul ca text și să-l parsez singur?

Poți primi tot corpul ca @RequestBody String sau un câmp ca JsonNode, dar de obicei e mai simplu și mai sigur să modelezi structura cu record-uri.

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.