...
Eroare Spring Boot · Excepții și răspunsuri de eroare

java.lang.IllegalArgumentException: No enum constant StatusComanda.livrata

Pe scurt

Enum.valueOf(text) a primit un text care nu este exact numele unei constante (diferă majusculele sau valoarea nu există). Normalizează textul (toUpperCase) și tratează valorile necunoscute, sau lasă Spring să convertească parametrul direct în enum.

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

Ce înseamnă

StatusComanda.valueOf("livrata") caută constanta cu exact acest nume. Comparația ține cont de majuscule, iar dacă nu găsește nimic aruncă IllegalArgumentException: No enum constant StatusComanda.livrata. Mesajul conține numele complet al enum-ului și textul primit.

Într-un controller, eroarea apare când citești un parametru ca String și îl convertești singur. Excepția nu e tratată, deci clientul primește 500, deși problema e o valoare greșită de la el (ar trebui 400).

Două reparații bune: declari parametrul direct cu tipul enum (@RequestParam StatusComanda status), iar Spring răspunde singur 400 pentru valori greșite; sau, dacă vrei să accepți litere mici, normalizezi textul cu toUpperCase() și tratezi valorile necunoscute explicit.

De ce apare: cauzele frecvente

1Majuscule diferite

Greșit
JAVA
StatusComanda s = StatusComanda.valueOf(status);   // "livrata"
Corect
JAVA
StatusComanda s = StatusComanda.valueOf(status.toUpperCase());

Constantele sunt scrise cu majuscule, iar valueOf compară exact.

2Valoare necunoscută netratată

Greșit
JAVA
StatusComanda.valueOf("pierduta");
Corect
JAVA
try {
    return StatusComanda.valueOf(text.toUpperCase());
} catch (IllegalArgumentException e) {
    throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "Status necunoscut: " + text);
}

O valoare greșită de la client trebuie să dea 400, nu 500.

Repară tu

Repară eroarea, direct în pagină

GET /comenzi?status=livrata răspunde 500 cu No enum constant StatusComanda.livrata, pentru că metoda convertește textul cu valueOf. Normalizează textul la majuscule înainte de conversie, ca ruta să răspundă Comenzi cu statusul LIVRATA: 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);
    }
}

enum StatusComanda {
    NOUA, LIVRATA, ANULATA
}

@RestController
class ComandaController {
    private final List<StatusComanda> comenzi = List.of(StatusComanda.NOUA, StatusComanda.LIVRATA, StatusComanda.LIVRATA);

    @GetMapping("/comenzi")
    String numara(@RequestParam String status) {
        StatusComanda s = StatusComanda.valueOf(status);
        long n = comenzi.stream().filter(c -> c == s).count();
        return "Comenzi cu statusul " + s + ": " + n;
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /comenzi?status=livrata → 200
Comenzi cu statusul LIVRATA: 2
Indiciu

String are o metodă care transformă textul în majuscule.

Alte forme ale mesajului

  • No enum constant StatusComanda.Livrata
  • IllegalArgumentException: No enum constant com.magazin.Categorie.electronice

Cum o eviți pe viitor

  • Lasă Spring să convertească parametrii direct în enum: primești 400 automat pentru valori greșite.
  • Când convertești singur, normalizează textul și tratează IllegalArgumentException.
  • Documentează valorile acceptate ale fiecărui enum din API.
  • Pentru texte prietenoase (cu diacritice), adaugă enum-ului un câmp și o metodă de căutare proprie.

Întrebări frecvente

Există un valueOf care ignoră majusculele?

Nu în JDK. Fie normalizezi textul cu toUpperCase(), fie cauți singur printre values() cu equalsIgnoreCase.

De ce primesc 500 și nu 400?

Pentru că excepția vine din codul tău, nu din conversia Spring. Spring nu știe că e o greșeală a clientului.

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.