...
Eroare Spring Boot · JSON și Jackson

JSON parse error: Cannot deserialize value of type `java.util.ArrayList<ProdusNou>` from Object value (token `JsonToken.START_OBJECT`)

Pe scurt

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ă

Greșit
JAVA
POST /produse/lot
{"nume": "Mouse"}

@RequestBody List<ProdusNou> produse
Corect
JAVA
POST /produse/lot
[{"nume": "Mouse"}]

O listă se trimite ca tablou JSON, chiar dacă are un singur element.

2Listă împachetată într-un obiect

Greșit
JAVA
{"produse": [{"nume": "Mouse"}]}

@RequestBody List<ProdusNou> produse
Corect
JAVA
record Lot(List<ProdusNou> produse) { }

@RequestBody Lot lot

Dacă clientul trimite un obiect cu o listă în el, parametrul trebuie să fie acel obiect.

3Parametru declarat listă din greșeală

Greșit
JAVA
@PostMapping("/produse")
String adauga(@RequestBody List<ProdusNou> p)
Corect
JAVA
@PostMapping("/produse")
String adauga(@RequestBody ProdusNou p)

Ruta de creare primește de obicei un singur obiect.

Repară tu

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.

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.*;

@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();
    }
}
După reparație, programul afișează
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>.

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

← 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.