...
Eroare Spring Boot · Repository-uri, interogări și paginare

Could not resolve root entity 'produse'

Pe scurt

Î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

Greșit
JAVA
@Query("SELECT p FROM produse p")
Corect
JAVA
@Query("SELECT p FROM Produs p")

produse e tabela; entitatea se numește Produs.

2Literă mică la numele clasei

Greșit
JAVA
@Query("SELECT c FROM comanda c WHERE c.total > 100")
Corect
JAVA
@Query("SELECT c FROM Comanda c WHERE c.total > 100")

Numele entității respectă exact numele clasei, cu majuscula.

3Entitatea are un nume explicit

Greșit
JAVA
@Entity(name = "Articol")
class Produs { }
@Query("SELECT p FROM Produs p")
Corect
JAVA
@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ă tu

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ă.

Codul care dă eroarea
JAVA
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);
    }
}
După reparație, programul afișează
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.

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 @Table pentru 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

← 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.