...
Eroare Spring Boot · JSON și Jackson

JSON parse error: Cannot deserialize value of type `StatusComanda` from String "livrata": not one of the values accepted for Enum class: [NOUA, LIVRATA, ANULATA]

Pe scurt

Valoarea din JSON nu corespunde exact niciunei constante a enum-ului: implicit, Jackson cere numele scris identic, cu aceleași majuscule. Trimite "LIVRATA", activează acceptarea fără majuscule sau mapează valorile cu @JsonProperty.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Pentru un câmp de tip enum, Jackson caută constanta cu exact același nume ca textul primit. "livrata" nu este LIVRATA, deci primești InvalidFormatException: Cannot deserialize value of type StatusComanda from String "livrata": not one of the values accepted for Enum class: [NOUA, LIVRATA, ANULATA]. Lista de la final îți arată toate valorile acceptate.

Cauze tipice: majuscule diferite (front-end-ul trimite litere mici), un nume vechi după ce ai redenumit o constantă, o valoare cu diacritice sau spații ("în livrare"), ori o valoare nouă pe care clientul o trimite înainte ca serverul să o cunoască.

Într-un controller rezultatul e 400. Ai mai multe variante: trimiți exact numele constantei, activezi spring.jackson.mapper.accept-case-insensitive-enums=true, sau declari forma JSON a fiecărei constante cu @JsonProperty("livrata").

De ce apare: cauzele frecvente

1Majuscule diferite

Greșit
JAVA
{"status": "livrata"}
Corect
JAVA
{"status": "LIVRATA"}

Implicit, comparația este exactă.

2Clientul folosește alte texte

Greșit
JAVA
enum StatusComanda { NOUA, LIVRATA }
// clientul trimite "livrata"
Corect
JAVA
enum StatusComanda {
    @JsonProperty("noua") NOUA,
    @JsonProperty("livrata") LIVRATA
}

@JsonProperty stabilește textul JSON al fiecărei constante, la citire și la scriere.

3Constantă redenumită

Greșit
JAVA
// înainte: TRIMISA, acum: LIVRATA
{"status": "TRIMISA"}
Corect
JAVA
enum StatusComanda {
    @JsonAlias("TRIMISA") LIVRATA
}

@JsonAlias acceptă și numele vechi, ca clienții să aibă timp să se actualizeze.

Repară tu

Repară eroarea, direct în pagină

GET /import răspunde 500: not one of the values accepted for Enum class. Furnizorul trimite statusul livrata cu litere mici, iar enum-ul are constanta LIVRATA. Corectează textul din constanta JSON, ca ruta să răspundă Comanda 7: LIVRATA.

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.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.math.BigDecimal;
import java.time.LocalDate;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

enum StatusComanda {
    NOUA, LIVRATA, ANULATA
}

record Comanda(long id, StatusComanda status) {
}

@RestController
class ImportController {
    // textul primit de la furnizor (în aplicația reală vine dintr-un fișier sau dintr-un API)
    static final String JSON = """
            {"id": 7, "status": "livrata"}
            """;

    private final ObjectMapper mapper;

    ImportController(ObjectMapper mapper) {
        this.mapper = mapper;
    }

    @GetMapping("/import")
    String importa() throws Exception {
        Comanda c = mapper.readValue(JSON, Comanda.class);
        return "Comanda " + c.id() + ": " + c.status();
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /import → 200
Comanda 7: LIVRATA
Indiciu

Valoarea trebuie să fie scrisă exact ca numele constantei.

Alte forme ale mesajului

  • Cannot deserialize value of type `Categorie` from String "electronice": not one of the values accepted for Enum class: [ELECTRONICE, CARTI]

Cum o eviți pe viitor

  • Stabilește și documentează forma exactă a valorilor de enum din API.
  • Când redenumești o constantă, păstrează numele vechi cu @JsonAlias o perioadă.
  • Pentru clienți tolerați, activează spring.jackson.mapper.accept-case-insensitive-enums=true.
  • Tratează eroarea într-un @RestControllerAdvice și răspunde cu lista valorilor acceptate.

Întrebări frecvente

Pot accepta orice majuscule?

Da, cu proprietatea spring.jackson.mapper.accept-case-insensitive-enums=true sau cu @JsonFormat(with = JsonFormat.Feature.ACCEPT_CASE_INSENSITIVE_PROPERTIES) pe câmp.

Ce se întâmplă cu valori necunoscute?

Cu @JsonEnumDefaultValue pe o constantă și READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE activat, valorile necunoscute devin constanta implicită în loc de eroare.

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.