java.lang.IllegalArgumentException: No enum constant StatusComanda.livrata
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
StatusComanda s = StatusComanda.valueOf(status); // "livrata"StatusComanda s = StatusComanda.valueOf(status.toUpperCase());Constantele sunt scrise cu majuscule, iar valueOf compară exact.
2Valoare necunoscută netratată
StatusComanda.valueOf("pierduta");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ă 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.
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;
}
}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.
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.*;
@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.toUpperCase());
long n = comenzi.stream().filter(c -> c == s).count();
return "Comenzi cu statusul " + s + ": " + n;
}
}De ce merge
valueOf caută constanta cu numele identic, iar livrata nu este LIVRATA. Excepția aruncată din codul tău a ajuns netratată la Spring, de unde 500. Cu status.toUpperCase(), textul devine LIVRATA, iar conversia reușește. Pentru valori complet necunoscute ai avea în continuare excepția: în cod real o prinzi și răspunzi 400, sau declari parametrul direct ca StatusComanda.
Alte forme ale mesajului
No enum constant StatusComanda.LivrataIllegalArgumentException: 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
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. 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. Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: java.lang.IllegalStateException: Stoc insuficient pentru Mouse] with root cause O excepție aruncată din controller sau serviciu nu a fost tratată nicăieri, a ajuns până la servlet, iar clientul a primit 500. Excepția reală e în paranteze și în stiva de sub mesaj. Repar-o sau trateaz-o cu un @ExceptionHandler care întoarce statusul potrivit. Î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.
