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 {...}.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Este inversul erorii „from Object value”. Parametrul @RequestBody ProdusNou produs cere un obiect JSON ({), dar corpul începe cu [ (JsonToken.START_ARRAY), adică un tablou. Jackson nu poate pune o listă într-un singur obiect și aruncă MismatchedInputException: Cannot deserialize value of type ProdusNou from Array value.
Situații tipice: un import în bloc trimis către ruta de creare a unui singur element; un front-end care trimite mereu liste (de exemplu rândurile selectate dintr-un tabel); sau un câmp dintr-un obiect, declarat ca obiect, dar trimis ca listă ("adresa": [{...}]). În ultimul caz, mesajul are la final calea câmpului (through reference chain: Client["adresa"]).
Răspunsul în controller este 400.
De ce apare: cauzele frecvente
1Ruta de import primește un singur obiect
POST /produse/import
[{"nume": "Mouse"}, {"nume": "Cablu"}]
@RequestBody ProdusNou produs@PostMapping("/produse/import")
String importa(@RequestBody List<ProdusNou> produse)Un tablou JSON se citește într-o listă.
2Câmp listă declarat ca obiect
record Client(String nume, Adresa adresa) { }
// JSON: "adresa": [{...}]record Client(String nume, List<Adresa> adrese) { }Tipul câmpului trebuie să corespundă formei din JSON.
Repară eroarea, direct în pagină
Ruta POST /produse/import primește un tablou de produse, dar metoda cere un singur ProdusNou și răspunde 400: Cannot deserialize value of type ProdusNou from Array value. Schimbă parametrul ca ruta să primească lista și să răspundă Importate: 2.
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 ImportController {
@PostMapping("/produse/import")
String importa(@RequestBody ProdusNou produs) {
return "Importate: 1";
}
}Tomcat started on port 8080 (http) Started Application POST /produse/import → 200 Importate: 2
Indiciu
Un tablou JSON se citește într-un 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 ImportController {
@PostMapping("/produse/import")
String importa(@RequestBody List<ProdusNou> produse) {
return "Importate: " + produse.size();
}
}De ce merge
Corpul începea cu [, deci era un tablou, iar parametrul cerea un singur obiect. Jackson nu poate alege un element din listă, așa că a refuzat conversia. Cu List<ProdusNou>, fiecare element din tablou devine un ProdusNou, iar size() dă numărul lor. Tipul parametrului trebuie să reflecte exact forma datelor trimise.
Alte forme ale mesajului
Cannot deserialize value of type `java.lang.String` from Array value (token `JsonToken.START_ARRAY`)
Cum o eviți pe viitor
- Pentru fiecare rută și câmp, stabilește dacă primește un element sau o listă.
- Folosește nume la plural pentru câmpurile listă (
adrese), ca forma să fie evidentă. - Scrie exemple de corp în documentația API-ului (OpenAPI) și testează exact cu ele.
Întrebări frecvente
Pot primi și un element, și o listă pe aceeași rută?
Cu ACCEPT_SINGLE_VALUE_AS_ARRAY, un element singur este acceptat într-o listă. Invers (listă într-un obiect) nu se poate.
Cum aflu câmpul greșit într-un obiect mare?
Mesajul complet se termină cu through reference chain, care arată calea până la câmp.
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. 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: Cannot deserialize value of type `int` from String "doi": not a valid `int` value Un câmp numeric din JSON are un text care nu e număr ("doi", "", "10 buc"). Jackson poate converti "2" în 2, dar nu și cuvinte. Trimite numărul ca număr JSON (2) sau corectează sursa datelor. Î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.
