...
Eroare Spring Boot · Rute și cereri HTTP: 404, 405, 400

Invalid value 'crescator' for orders given; Has to be either 'desc' or 'asc' (case insensitive)

Pe scurt

Sort.Direction.fromString primește doar textele asc sau desc (cu orice fel de litere). Orice altă valoare, de exemplu crescator, aruncă IllegalArgumentException, iar cererea primește 500. Transformă tu parametrul în Sort.Direction.ASC / DESC sau validează-l înainte.

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

Ce înseamnă

Mesajul vine din Sort.Direction.fromString(String) din Spring Data. Metoda transformă un text în direcția de sortare și acceptă doar asc și desc (fără să conteze literele mari). Pentru orice altă valoare aruncă IllegalArgumentException: Invalid value 'crescator' for orders given; Has to be either 'desc' or 'asc' (case insensitive).

Eroarea apare de obicei când direcția vine direct din cerere, dintr-un @RequestParam, iar interfața trimite alte cuvinte (crescator, up, ascending) sau un text gol. Fiind o excepție neprinsă, clientul primește 500, deși greșeala este în datele lui.

Același mesaj îl poți vedea și când folosești parametrul standard ?sort=pret,crescator cu un Pageable: partea de după virgulă trebuie să fie asc sau desc.

De ce apare: cauzele frecvente

1Cuvântul din interfață ajunge direct în fromString

Greșit
JAVA
Sort.Direction d = Sort.Direction.fromString(ordine);
// ?ordine=crescator
Corect
JAVA
Sort.Direction d = ordine.equals("descrescator")
        ? Sort.Direction.DESC : Sort.Direction.ASC;

Faci tu traducerea din vocabularul interfeței în valorile pe care le acceptă Spring Data.

2Valoarea poate lipsi sau poate fi greșită

Greșit
JAVA
@RequestParam String ordine
Corect
JAVA
@RequestParam(defaultValue = "asc") String ordine
// și Sort.Direction.fromOptionalString(ordine).orElse(Sort.Direction.ASC)

fromOptionalString întoarce Optional.empty() pentru o valoare necunoscută, în loc să arunce excepție.

3Parametrul sort al unui Pageable

Greșit
JAVA
GET /produse?sort=pret,crescator
Corect
JAVA
GET /produse?sort=pret,asc

Formatul standard este proprietate,asc|desc, iar Spring construiește singur Sort-ul din el.

Repară tu

Repară eroarea, direct în pagină

GET /produse?ordine=crescator răspunde 500 cu Invalid value 'crescator' for orders given. Interfața magazinului trimite crescator sau descrescator. Transformă tu cuvântul în direcția Spring Data, ca produsele să vină sortate după preț în ordinea cerută.

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.data.domain.Sort;
import org.springframework.data.jpa.repository.JpaRepository;
import jakarta.persistence.*;
import java.util.*;

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

@Entity
class Produs {
    @Id @GeneratedValue
    private Long id;
    private String nume;
    private int pret;

    protected Produs() { }

    public Long getId() { return id; }
    public String getNume() { return nume; }
    public int getPret() { return pret; }
}

interface ProdusRepository extends JpaRepository<Produs, Long> { }

@RestController
class ProdusController {
    private final ProdusRepository repo;

    ProdusController(ProdusRepository repo) {
        this.repo = repo;
    }

    // ordine = crescator sau descrescator (așa trimite interfața magazinului)
    @GetMapping("/produse")
    List<Produs> toate(@RequestParam String ordine) {
        // TODO: transformă cuvântul românesc în Sort.Direction
        Sort.Direction directie = Sort.Direction.fromString(ordine);
        return repo.findAll(Sort.by(directie, "pret"));
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /produse?ordine=crescator → 200
[{"id":2,"nume":"Mouse","pret":89},{"id":3,"nume":"Tastatură","pret":199},{"id":1,"nume":"Monitor","pret":899}]
GET /produse?ordine=descrescator → 200
[{"id":1,"nume":"Monitor","pret":899},{"id":3,"nume":"Tastatură","pret":199},{"id":2,"nume":"Mouse","pret":89}]
Indiciu

Compară ordine cu "descrescator" și alege Sort.Direction.DESC sau Sort.Direction.ASC.

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: Invalid value 'up' for orders given; Has to be either 'desc' or 'asc' (case insensitive)
  • Invalid value '' for orders given; Has to be either 'desc' or 'asc' (case insensitive)

Cum o eviți pe viitor

  • Nu da textul din cerere direct lui fromString: folosește fromOptionalString sau o mapare explicită.
  • Pune o valoare implicită pentru direcție (defaultValue = "asc").
  • Pentru valori fixe, primește parametrul ca enum propriu și tratează conversia greșită ca 400.
  • Documentează valorile acceptate în specificația API.

Întrebări frecvente

De ce primesc 500 și nu 400?

Pentru Spring MVC, IllegalArgumentException aruncată din codul tău e o eroare a serverului. Dacă vrei 400, validează parametrul și aruncă ResponseStatusException(HttpStatus.BAD_REQUEST, ...).

Contează literele mari?

Nu. ASC, Asc și asc sunt acceptate; contează doar ca textul să fie unul dintre cele două cuvinte.

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.