...
Eroare Spring Boot · JSON și Jackson

JSON parse error: Cannot deserialize value of type `ProdusNou` from Array value (token `JsonToken.START_ARRAY`)

Pe scurt

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

Greșit
JAVA
POST /produse/import
[{"nume": "Mouse"}, {"nume": "Cablu"}]

@RequestBody ProdusNou produs
Corect
JAVA
@PostMapping("/produse/import")
String importa(@RequestBody List<ProdusNou> produse)

Un tablou JSON se citește într-o listă.

2Câmp listă declarat ca obiect

Greșit
JAVA
record Client(String nume, Adresa adresa) { }
// JSON: "adresa": [{...}]
Corect
JAVA
record Client(String nume, List<Adresa> adrese) { }

Tipul câmpului trebuie să corespundă formei din JSON.

Repară tu

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.

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 ImportController {
    @PostMapping("/produse/import")
    String importa(@RequestBody ProdusNou produs) {
        return "Importate: 1";
    }
}
După reparație, programul afișează
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>.

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

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