JSON parse error: Cannot deserialize value of type `StatusComanda` from String "livrata": not one of the values accepted for Enum class: [NOUA, LIVRATA, ANULATA]
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
{"status": "livrata"}{"status": "LIVRATA"}Implicit, comparația este exactă.
2Clientul folosește alte texte
enum StatusComanda { NOUA, LIVRATA }
// clientul trimite "livrata"enum StatusComanda {
@JsonProperty("noua") NOUA,
@JsonProperty("livrata") LIVRATA
}@JsonProperty stabilește textul JSON al fiecărei constante, la citire și la scriere.
3Constantă redenumită
// înainte: TRIMISA, acum: LIVRATA
{"status": "TRIMISA"}enum StatusComanda {
@JsonAlias("TRIMISA") LIVRATA
}@JsonAlias acceptă și numele vechi, ca clienții să aibă timp să se actualizeze.
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.
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();
}
}Tomcat started on port 8080 (http) Started Application GET /import → 200 Comanda 7: LIVRATA
Indiciu
Valoarea trebuie să fie scrisă exact ca numele constantei.
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.*;
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();
}
}De ce merge
Jackson caută constanta enum cu numele identic textului din JSON. livrata diferă de LIVRATA prin majuscule, deci nu s-a găsit nicio potrivire, iar mesajul a listat valorile acceptate. Cu "LIVRATA" conversia reușește. Dacă nu poți schimba clientul, alternativa este pe server: accept-case-insensitive-enums sau @JsonProperty pe fiecare constantă.
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
@JsonAliaso 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
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. JSON parse error: Cannot deserialize value of type `java.time.LocalDate` from String "01.03.2026": Failed to deserialize java.time.LocalDate Data din JSON nu e în formatul ISO pe care îl așteaptă Jackson pentru LocalDate (aaaa-ll-zz, de exemplu 2026-03-01). Trimite data în format ISO sau declară formatul pe câmp cu @JsonFormat(pattern = "dd.MM.yyyy"). Method parameter 'id': Failed to convert value of type 'java.lang.String' to required type 'long'; For input string: "recomandate" Valoarea din cale sau din query nu se poate converti în tipul parametrului (aici un text în loc de număr), deci Spring răspunde 400. Adesea cererea a ajuns la ruta /{id} din greșeală: verifică ruta dedicată și tipul parametrului. Î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.
