Unable to locate Attribute with the given name [pretul] on this ManagedType [Produs]
Ai cerut sortarea (Sort sau ?sort= în Pageable) după un câmp care nu există în entitate. Hibernate nu găsește atributul și interogarea pică cu 500. Sortează doar după câmpuri existente și, dacă sortarea vine de la client, permite doar o listă de câmpuri cunoscute.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când apelezi findAll(pageable) sau findAll(Sort.by("pretul")), Spring Data adaugă la interogare order by pe proprietatea cerută. Pentru asta cere metamodelului JPA atributul cu acel nume. Dacă nu există, Hibernate aruncă IllegalArgumentException: Unable to locate Attribute with the given name [pretul] on this ManagedType [Produs], iar Spring o împachetează în InvalidDataAccessApiUsageException. Rezultatul: 500.
Spre deosebire de metodele derivate greșite, eroarea nu apare la pornire, ci la cerere, pentru că numele câmpului vine de obicei de la client: GET /produse?sort=pretul,desc. Orice client poate provoca un 500 trimițând un nume aleator, deci problema e și de robustețe a API-ului.
În metodele derivate cu Pageable, aceeași greșeală apare ca PropertyReferenceException: No property 'pretul' found for type 'Produs'.
De ce apare: cauzele frecvente
1Clientul trimite un câmp inexistent în sort
GET /produse?sort=pretul,desc
Page<Produs> lista(Pageable p) {
return repo.findAll(p);
}Set<String> permise = Set.of("nume", "pret");
if (p.getSort().stream().anyMatch(o -> !permise.contains(o.getProperty())))
throw new ResponseStatusException(HttpStatus.BAD_REQUEST);Validezi sortarea înainte de interogare și răspunzi 400 pentru câmpuri necunoscute.
2Ai scris greșit numele în cod
repo.findAll(Sort.by("pretul"))repo.findAll(Sort.by("pret"))Numele din Sort.by este numele câmpului Java.
3Sortezi după numele coloanei
Sort.by("pret_unitar")Sort.by("pretUnitar")Sortarea folosește câmpurile entității, nu coloanele.
Repară eroarea, direct în pagină
GET /produse?sortare=pretul dă 500 cu Unable to locate Attribute with the given name [pretul]. Permite sortarea doar după nume și pret: pentru orice alt câmp răspunde 400, iar sortare=pret trebuie să funcționeze.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import org.springframework.data.domain.Sort;
import org.springframework.http.HttpStatus;
import org.springframework.web.server.ResponseStatusException;
import org.springframework.web.bind.annotation.*;
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 String categorie;
private int pret;
protected Produs() {
}
public Long getId() { return id; }
public String getNume() { return nume; }
public String getCategorie() { return categorie; }
public int getPret() { return pret; }
}
interface ProdusRepository extends JpaRepository<Produs, Long> {
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse")
List<Produs> sortate(@RequestParam(defaultValue = "nume") String sortare) {
// TODO: permite doar câmpurile nume și pret
return repo.findAll(Sort.by(sortare));
}
}Tomcat started on port 8080 (http)
Started Application
GET /produse?sortare=pretul → 400
{"status":400,"error":"Bad Request","message":"Se poate sorta doar după nume sau pret","path":"/produse"}
GET /produse?sortare=pret → 200
[{"id":1,"nume":"Mouse","categorie":"periferice","pret":89},{"id":2,"nume":"Tastatură","categorie":"periferice","pret":199},{"id":4,"nume":"Webcam","categorie":"periferice","pret":249},{"id":3,"nume":"Monitor","categorie":"ecrane","pret":799}]Indiciu
Verifică parametrul față de o mulțime de câmpuri permise înainte de Sort.by.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import org.springframework.data.domain.Sort;
import org.springframework.http.HttpStatus;
import org.springframework.web.server.ResponseStatusException;
import org.springframework.web.bind.annotation.*;
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 String categorie;
private int pret;
protected Produs() {
}
public Long getId() { return id; }
public String getNume() { return nume; }
public String getCategorie() { return categorie; }
public int getPret() { return pret; }
}
interface ProdusRepository extends JpaRepository<Produs, Long> {
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse")
List<Produs> sortate(@RequestParam(defaultValue = "nume") String sortare) {
if (!Set.of("nume", "pret").contains(sortare)) {
throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "Se poate sorta doar după nume sau pret");
}
return repo.findAll(Sort.by(sortare));
}
}De ce merge
Numele câmpului de sortare venea direct de la client, iar Hibernate nu găsea atributul pretul, deci 500. Acum ruta compară valoarea cu o listă albă (nume, pret) și răspunde 400 cu un mesaj clar pentru orice altceva. Valorile permise ajung la Sort.by și funcționează ca înainte.
Alte forme ale mesajului
org.springframework.dao.InvalidDataAccessApiUsageException: Unable to locate Attribute with the given name [pretul] on this ManagedType [Produs]org.springframework.data.mapping.PropertyReferenceException: No property 'pretul' found for type 'Produs'
Cum o eviți pe viitor
- Nu trimite orbește
Pageable-ul de la client în repository: permite sortarea doar după o listă de câmpuri. - Folosește constante sau metamodelul JPA pentru numele câmpurilor din
Sort.by. - Tratează
InvalidDataAccessApiUsageException/PropertyReferenceExceptionca 400 într-un@RestControllerAdvice. - Testează și o sortare invalidă, nu doar pe cele valide.
Întrebări frecvente
De ce eroarea nu apare la pornire?
Pentru că numele câmpului de sortare e cunoscut abia la cerere. Spring Data nu are ce verifica la pornire.
Ce cod HTTP e corect pentru o sortare invalidă?
400 Bad Request, cu un mesaj care spune după ce câmpuri se poate sorta. 500 ar însemna că serverul a greșit, deși clientul a trimis o valoare greșită.
Erori înrudite
No property 'pretul' found for type 'Produs' Numele unei metode derivate (findBy...) pomenește un câmp care nu există în entitate, așa că Spring Data nu poate construi interogarea și aplicația nu pornește. Scrie după findBy numele exact al câmpului, cu prima literă mare: findByPret pentru câmpul pret. Page size must not be less than one Ai creat un PageRequest cu mărimea paginii 0 sau negativă, de obicei dintr-un parametru primit de la client. PageRequest.of verifică și aruncă IllegalArgumentException (500). Validează mărimea (minim 1, plus o limită maximă) sau folosește Pageable, pe care Spring îl normalizează singur. Î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.
