mappedBy reference an unknown target entity property: Produs.categoria in Categorie.produse
Valoarea din mappedBy trebuie să fie numele câmpului care deține relația în cealaltă entitate. Ai scris un nume care nu există acolo (categoria în loc de categorie), iar Hibernate oprește pornirea. Copiază exact numele câmpului @ManyToOne din entitatea copil.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Într-o relație bidirecțională, o singură parte deține cheia străină: de obicei @ManyToOne Categorie categorie din Produs. Partea cealaltă, @OneToMany(mappedBy = "categorie") List<Produs> produse din Categorie, spune doar „sunt oglinda câmpului categorie din Produs”. Hibernate caută acel câmp la pornire; dacă nu-l găsește, aruncă AnnotationException: mappedBy reference an unknown target entity property: Produs.categoria in Categorie.produse.
Citește mesajul de la dreapta la stânga: în colecția Categorie.produse ai scris mappedBy = "categoria", dar în Produs nu există un câmp categoria. În Hibernate 6.2+ mesajul e formulat altfel: Association 'Categorie.produse' is 'mappedBy' a property named 'categoria' which does not exist in the target entity 'Produs'.
Aplicația nu pornește, deci o observi imediat după ce ai scris relația sau ai redenumit câmpul.
De ce apare: cauzele frecvente
1Nume diferit de câmpul din copil
@OneToMany(mappedBy = "categoria")
List<Produs> produse;
// în Produs: @ManyToOne Categorie categorie;@OneToMany(mappedBy = "categorie")
List<Produs> produse;mappedBy primește numele câmpului Java din Produs, nu al coloanei și nu al clasei.
2Ai pus numele coloanei
@OneToMany(mappedBy = "categorie_id")@OneToMany(mappedBy = "categorie")categorie_id e coloana generată; relația se leagă prin câmp.
3Ai redenumit câmpul doar într-o parte
// Produs: @ManyToOne Categorie grupa;
@OneToMany(mappedBy = "categorie")// Produs: @ManyToOne Categorie grupa;
@OneToMany(mappedBy = "grupa")Când redenumești câmpul proprietar, actualizează și mappedBy.
Repară eroarea, direct în pagină
Colecția produse din Categorie are mappedBy = "categoria", iar în proiectul real aplicația nu pornește cu mappedBy reference an unknown target entity property. Corectează valoarea ca GET /categorii/1/produse să întoarcă produsele categoriei.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import com.fasterxml.jackson.annotation.JsonIgnore;
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 Categorie {
@Id
@GeneratedValue
private Long id;
private String nume;
@OneToMany(mappedBy = "categoria")
private List<Produs> produse = new ArrayList<>();
protected Categorie() {
}
Categorie(String nume) {
this.nume = nume;
}
public Long getId() { return id; }
public String getNume() { return nume; }
public List<Produs> getProduse() { return produse; }
}
@Entity
class Produs {
@Id
@GeneratedValue
private Long id;
private String nume;
@ManyToOne
@JsonIgnore
private Categorie categorie;
protected Produs() {
}
Produs(String nume, Categorie categorie) {
this.nume = nume;
this.categorie = categorie;
}
public Long getId() { return id; }
public String getNume() { return nume; }
public Categorie getCategorie() { return categorie; }
}
interface CategorieRepository extends JpaRepository<Categorie, Long> {
}
interface ProdusRepository extends JpaRepository<Produs, Long> {
}
@RestController
class CategorieController {
private final CategorieRepository repo;
CategorieController(CategorieRepository repo) {
this.repo = repo;
}
@GetMapping("/categorii/{id}/produse")
List<String> produse(@PathVariable long id) {
return repo.findById(id).orElseThrow().getProduse().stream().map(p -> p.getNume()).toList();
}
}Tomcat started on port 8080 (http) Started Application GET /categorii/1/produse → 200 ["Mouse","Tastatură"]
Indiciu
Ce nume are câmpul @ManyToOne din clasa Produs?
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import com.fasterxml.jackson.annotation.JsonIgnore;
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 Categorie {
@Id
@GeneratedValue
private Long id;
private String nume;
@OneToMany(mappedBy = "categorie")
private List<Produs> produse = new ArrayList<>();
protected Categorie() {
}
Categorie(String nume) {
this.nume = nume;
}
public Long getId() { return id; }
public String getNume() { return nume; }
public List<Produs> getProduse() { return produse; }
}
@Entity
class Produs {
@Id
@GeneratedValue
private Long id;
private String nume;
@ManyToOne
@JsonIgnore
private Categorie categorie;
protected Produs() {
}
Produs(String nume, Categorie categorie) {
this.nume = nume;
this.categorie = categorie;
}
public Long getId() { return id; }
public String getNume() { return nume; }
public Categorie getCategorie() { return categorie; }
}
interface CategorieRepository extends JpaRepository<Categorie, Long> {
}
interface ProdusRepository extends JpaRepository<Produs, Long> {
}
@RestController
class CategorieController {
private final CategorieRepository repo;
CategorieController(CategorieRepository repo) {
this.repo = repo;
}
@GetMapping("/categorii/{id}/produse")
List<String> produse(@PathVariable long id) {
return repo.findById(id).orElseThrow().getProduse().stream().map(p -> p.getNume()).toList();
}
}De ce merge
mappedBy leagă colecția de câmpul proprietar din cealaltă entitate. Produs are câmpul categorie, deci valoarea corectă e "categorie". Cu numele greșit, Hibernate nu găsea câmpul și oprea pornirea; după corectare, colecția oglindește cheia străină categorie_id, iar categoria 1 are Mouse și Tastatură.
Alte forme ale mesajului
org.hibernate.AnnotationException: mappedBy reference an unknown target entity property: com.magazin.model.Produs.categoria in com.magazin.model.Categorie.produseAssociation 'Categorie.produse' is 'mappedBy' a property named 'categoria' which does not exist in the target entity 'Produs'
Cum o eviți pe viitor
- Scrie întâi partea proprietară (
@ManyToOne), apoi copiază numele câmpului înmappedBy. - Folosește redenumirea din IDE: IntelliJ actualizează și textul din
mappedBy. - Întreabă-te dacă ai nevoie de relația bidirecțională; adesea
@ManyToOnesingur și o interogarefindByCategorieIdajung. - Pornește aplicația după fiecare relație nouă.
Întrebări frecvente
Care parte e proprietara relației?
Cea cu cheia străină, adică @ManyToOne (sau partea fără mappedBy la @OneToOne/@ManyToMany). Doar modificările ei se scriu în bază.
Laboratorul pornește cu mappedBy greșit. De ce?
Simulatorul nu validează mappedBy la pornire, ca Hibernate; în exercițiu eroarea apare abia la citirea colecției (500). În proiectul real, aplicația nu pornește deloc.
Erori înrudite
LazyInitializationException: failed to lazily initialize a collection of role: Categorie.produse: could not initialize proxy - no Session Ai citit o relație LAZY (de obicei o colecție @OneToMany) după ce tranzacția s-a închis, de exemplu când Jackson serializează entitatea în controller. Încarcă datele de care ai nevoie în service, într-o metodă @Transactional(readOnly = true), și întoarce un DTO (sau folosește JOIN FETCH). A collection with cascade="all-delete-orphan" was no longer referenced by the owning entity instance: Comanda.linii Pe o colecție cu orphanRemoval = true ai înlocuit lista cu una nouă (setLinii(new ArrayList<>())). Hibernate urmărește lista originală ca să știe ce rânduri să șteargă și refuză înlocuirea. Modifică lista existentă: getLinii().clear(), apoi addAll(...). Î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.
