Could not resolve root entity 'produse'
În JPQL, după FROM vine numele clasei entității (Produs), nu numele tabelei (produse). Hibernate nu găsește o entitate cu numele scris și refuză interogarea la pornire. Scrie FROM Produs p, cu exact numele clasei.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În @Query, FROM primește o entitate, adică numele clasei Java (sau cel din @Entity(name = "...")). Când scrii SELECT p FROM produse p, Hibernate caută o entitate numită produse, nu o găsește și aruncă în Hibernate 6 UnknownEntityException: Could not resolve root entity 'produse'. În Hibernate 5 (Spring Boot 2) mesajul era QuerySyntaxException: produse is not mapped.
Spring Data verifică interogarea la pornire, deci vezi Validation failed for query for method ... și aplicația nu pornește.
Greșeala vine din obiceiul SQL: în SQL scrii tabela, în JPQL scrii clasa. Contează și literele mari: FROM produs nu e același lucru cu FROM Produs, pentru că numele entităților sunt sensibile la majuscule, chiar dacă tabela din bază nu este.
De ce apare: cauzele frecvente
1Numele tabelei în loc de entitate
@Query("SELECT p FROM produse p")@Query("SELECT p FROM Produs p")produse e tabela; entitatea se numește Produs.
2Literă mică la numele clasei
@Query("SELECT c FROM comanda c WHERE c.total > 100")@Query("SELECT c FROM Comanda c WHERE c.total > 100")Numele entității respectă exact numele clasei, cu majuscula.
3Entitatea are un nume explicit
@Entity(name = "Articol")
class Produs { }
@Query("SELECT p FROM Produs p")@Entity(name = "Articol")
class Produs { }
@Query("SELECT a FROM Articol a")@Entity(name = ...) schimbă numele folosit în JPQL (nu @Table, care schimbă doar tabela).
Repară eroarea, direct în pagină
Aplicația nu pornește: interogarea JPQL folosește numele tabelei. Corecteaz-o ca GET /produse/categorie/periferice să întoarcă produsele categoriei, ordonate după nume. Nu modifica entitatea și nici numele tabelei din bază.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import org.springframework.data.repository.query.Param;
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> {
@Query("SELECT p FROM produse p WHERE p.categorie = :cat ORDER BY p.nume")
List<Produs> dinCategorie(@Param("cat") String cat);
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse/categorie/{cat}")
List<Produs> dinCategorie(@PathVariable String cat) {
return repo.dinCategorie(cat);
}
}Tomcat started on port 8080 (http)
Started Application
GET /produse/categorie/periferice → 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}]Indiciu
După FROM vine numele clasei entității.
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.repository.query.Param;
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> {
@Query("SELECT p FROM Produs p WHERE p.categorie = :cat ORDER BY p.nume")
List<Produs> dinCategorie(@Param("cat") String cat);
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse/categorie/{cat}")
List<Produs> dinCategorie(@PathVariable String cat) {
return repo.dinCategorie(cat);
}
}De ce merge
JPQL lucrează cu entități: FROM Produs p înseamnă „obiectele clasei Produs”. Hibernate traduce apoi entitatea în tabela ei. Cu FROM produse, căuta o entitate inexistentă și respingea interogarea la pornire. Restul interogării (p.categorie, p.nume) folosea deja corect câmpurile, deci era singura greșeală.
Alte forme ale mesajului
org.hibernate.query.sqm.UnknownEntityException: Could not resolve root entity 'produse'org.hibernate.hql.internal.ast.QuerySyntaxException: produse is not mapped [SELECT p FROM produse p]produse is not mapped
Cum o eviți pe viitor
- În JPQL scrie mereu numele clasei:
FROM Produs p. - Dacă ai nevoie de SQL cu tabele, folosește conștient
nativeQuery = true. - Nu da nume explicite entităților (
@Entity(name)) fără motiv: folosește@Tablepentru numele tabelei. - Verifică interogările pornind aplicația sau cu un test de repository.
Întrebări frecvente
Care e diferența dintre @Entity(name) și @Table(name)?
@Entity(name) schimbă numele entității în JPQL, @Table(name) schimbă doar numele tabelei din bază. De obicei vrei doar @Table.
De ce merge aceeași interogare în consola bazei?
Pentru că acolo rulezi SQL, unde tabela produse există. @Query fără nativeQuery e JPQL și lucrează cu entități.
Erori înrudite
Could not resolve attribute 'pretul' of 'Produs' Interogarea JPQL din @Query folosește un câmp care nu există în entitate. Hibernate validează interogările la pornire, așa că aplicația nu pornește. Scrie în JPQL numele câmpurilor Java (p.pret), nu numele coloanelor sau alte denumiri. Using named parameters for method public abstract java.util.List ProdusRepository.cauta(java.lang.String) but parameter 'Optional[n]' not found in annotated query Numele din @Param nu corespunde cu parametrul din interogare (:nume în query, @Param("n") în metodă). Spring Data nu poate lega valoarea și aplicația nu pornește. Folosește același nume în ambele locuri: :nume și @Param("nume"). Î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.
