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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Jackson citește primul caracter al corpului și îl compară cu tipul cerut. Pentru List<ProdusNou> se așteaptă la un tablou JSON, care începe cu [. Când corpul începe cu { (JsonToken.START_OBJECT), conversia e imposibilă: Cannot deserialize value of type java.util.ArrayList<ProdusNou> from Object value.
Apare des la adăugarea în bloc: ruta acceptă o listă de produse, iar clientul trimite un singur produs. Sau invers: ruta e gândită pentru un obiect, dar parametrul a fost declarat listă din greșeală. Altă cauză frecventă: clientul trimite lista „împachetată” într-un obiect ({"produse": [...]}), iar serverul așteaptă tabloul direct.
În controller rezultatul e 400. Decide forma corectă a API-ului și aliniază serverul și clientul.
De ce apare: cauzele frecvente
1Un singur obiect către o rută de listă
POST /produse/lot
{"nume": "Mouse"}
@RequestBody List<ProdusNou> produsePOST /produse/lot
[{"nume": "Mouse"}]O listă se trimite ca tablou JSON, chiar dacă are un singur element.
2Listă împachetată într-un obiect
{"produse": [{"nume": "Mouse"}]}
@RequestBody List<ProdusNou> produserecord Lot(List<ProdusNou> produse) { }
@RequestBody Lot lotDacă clientul trimite un obiect cu o listă în el, parametrul trebuie să fie acel obiect.
3Parametru declarat listă din greșeală
@PostMapping("/produse")
String adauga(@RequestBody List<ProdusNou> p)@PostMapping("/produse")
String adauga(@RequestBody ProdusNou p)Ruta de creare primește de obicei un singur obiect.
Repară eroarea, direct în pagină
Clientul trimite POST /produse cu un singur produs ({"nume": "Mouse"}), dar metoda așteaptă o listă și răspunde 400: Cannot deserialize value of type java.util.ArrayList<ProdusNou> from Object value. Ruta este pentru un singur produs: schimbă parametrul, ca răspunsul să fie Adăugat: Mouse.
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.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record ProdusNou(String nume) {
}
@RestController
class ProdusController {
@PostMapping("/produse")
String adauga(@RequestBody List<ProdusNou> produse) {
return "Adăugat: " + produse.get(0).nume();
}
}Tomcat started on port 8080 (http) Started Application POST /produse → 200 Adăugat: Mouse
Indiciu
Parametrul @RequestBody trebuie să aibă tipul ProdusNou, nu List<ProdusNou>.
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.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record ProdusNou(String nume) {
}
@RestController
class ProdusController {
@PostMapping("/produse")
String adauga(@RequestBody ProdusNou produs) {
return "Adăugat: " + produs.nume();
}
}De ce merge
Corpul cererii începea cu {, adică un obiect, iar parametrul cerea o listă, care în JSON începe cu [. Jackson nu transformă singur un obiect într-o listă, așa că Spring a răspuns 400. Ruta POST /produse creează un produs, deci tipul corect este ProdusNou. Pentru adăugare în bloc ai face o rută separată, cu List<ProdusNou> și un tablou în corp.
Alte forme ale mesajului
Cannot deserialize value of type `java.util.ArrayList<java.lang.Object>` from Object value (token `JsonToken.START_OBJECT`)
Cum o eviți pe viitor
- Hotărăște forma fiecărei rute: un obiect sau o listă, și documenteaz-o.
- Pentru operații în bloc, folosește o cale separată (
/produse/lot) și un tablou. - Pentru liste care pot crește cu metadate, preferă un obiect-înveliș (
{"produse": [...]}). - Scrie un test MockMvc cu exact corpul pe care îl trimite clientul.
Întrebări frecvente
Pot accepta și obiect, și listă?
Da, cu DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY (sau @JsonFormat(with = ACCEPT_SINGLE_VALUE_AS_ARRAY) pe câmp). E util pentru compatibilitate, dar face API-ul mai puțin clar.
Ce înseamnă START_OBJECT din mesaj?
Tokenul JSON găsit: START_OBJECT este {, START_ARRAY este [. Îți spune ce a trimis de fapt clientul.
Erori înrudite
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 {...}. 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ă. 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.
