JSON parse error: Cannot deserialize value of type `java.lang.String` from Object value (token `JsonToken.START_OBJECT`)
Î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
record ComandaNoua(String client, String adresa) { }
// {"client": "Ana", "adresa": {"oras": "Cluj"}}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
{"nume": "Mouse", "categorie": {"id": 3}}{"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
record Eveniment(String tip, String date) { }record Eveniment(String tip, JsonNode date) { }JsonNode (sau Map<String, Object>) acceptă orice obiect JSON, util când structura variază.
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.
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();
}
}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.
Reparația
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);
}
}
record Adresa(String oras, String strada) { }
record ComandaNoua(String client, Adresa adresa) { }
@RestController
class ComandaController {
@PostMapping("/comenzi")
String plaseaza(@RequestBody ComandaNoua c) {
return "Comanda pentru " + c.client() + ", livrare în " + c.adresa().oras();
}
}De ce merge
Jackson citea adresa ca text, dar în JSON găsea {, deci cererea era respinsă cu 400. Cu record Adresa(String oras, String strada) și câmpul Adresa adresa în ComandaNoua, structura Java corespunde exact JSON-ului, iar obiectul imbricat se citește automat. Acum poți folosi direct c.adresa().oras().
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=alwaysdoar î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
JSON parse error: Cannot deserialize value of type `java.util.ArrayList<ProdusNou>` from Object value (token `JsonToken.START_OBJECT`) Metoda așteaptă o listă (@RequestBody List<...>), dar clientul a trimis un singur obiect {...}. Trimite un tablou [{...}] sau schimbă parametrul să primească un singur obiect, după ce face ruta de fapt. JSON parse error: Cannot deserialize value of type `ProdusNou` from Array value (token `JsonToken.START_ARRAY`) Metoda așteaptă un singur obiect, dar clientul a trimis un tablou [...]. Dacă ruta trebuie să primească mai multe elemente, declară parametrul List<...>; altfel, clientul trebuie să trimită un singur obiect {...}. 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). Î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.
