...
Eroare Spring Boot · Relații și tranzacții

mappedBy reference an unknown target entity property: Produs.categoria in Categorie.produse

Pe scurt

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

Greșit
JAVA
@OneToMany(mappedBy = "categoria")
List<Produs> produse;
// în Produs: @ManyToOne Categorie categorie;
Corect
JAVA
@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

Greșit
JAVA
@OneToMany(mappedBy = "categorie_id")
Corect
JAVA
@OneToMany(mappedBy = "categorie")

categorie_id e coloana generată; relația se leagă prin câmp.

3Ai redenumit câmpul doar într-o parte

Greșit
JAVA
// Produs: @ManyToOne Categorie grupa;
@OneToMany(mappedBy = "categorie")
Corect
JAVA
// Produs: @ManyToOne Categorie grupa;
@OneToMany(mappedBy = "grupa")

Când redenumești câmpul proprietar, actualizează și mappedBy.

Repară tu

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.

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 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();
    }
}
După reparație, programul afișează
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?

Alte forme ale mesajului

  • org.hibernate.AnnotationException: mappedBy reference an unknown target entity property: com.magazin.model.Produs.categoria in com.magazin.model.Categorie.produse
  • Association '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 în mappedBy.
  • Folosește redenumirea din IDE: IntelliJ actualizează și textul din mappedBy.
  • Întreabă-te dacă ai nevoie de relația bidirecțională; adesea @ManyToOne singur și o interogare findByCategorieId ajung.
  • 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

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