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

detached entity passed to persist: Categorie

Pe scurt

Hibernate a primit pentru persist un obiect care are deja id (deci pare să existe în bază), dar nu e gestionat de sesiunea curentă. Apare des când pui cascade = ALL pe @ManyToOne și legi un obiect creat cu new și cu id setat. Încarcă obiectul din bază și scoate cascada de pe @ManyToOne.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

persist înseamnă „inserează un obiect nou”. Când Hibernate primește un obiect care are deja id, dar nu e atașat sesiunii, îl consideră detașat (un rând existent citit în altă sesiune sau construit de mână) și refuză să-l insereze: PersistentObjectException: detached entity passed to persist: Categorie.

Cu Spring Data, save() alege singur între persist (id null) și merge (id setat), deci rar apelezi persist direct. Eroarea apare de obicei prin cascadă: salvezi un Produs nou, relația @ManyToOne(cascade = CascadeType.ALL) propagă persist și asupra categoriei, iar categoria e un obiect construit cu new Categorie() căruia i-ai setat id-ul primit în cerere.

Alt caz: entitatea are @GeneratedValue, dar codul îi setează manual id-ul înainte de persist.

De ce apare: cauzele frecvente

1Cascadă pe @ManyToOne și categorie construită cu id

Greșit
JAVA
@ManyToOne(cascade = CascadeType.ALL)
private Categorie categorie;
...
Categorie c = new Categorie();
c.setId(dto.categorieId());
repo.save(new Produs(dto.nume(), c));
Corect
JAVA
@ManyToOne
private Categorie categorie;
...
Categorie c = categorii.findById(dto.categorieId()).orElseThrow();
repo.save(new Produs(dto.nume(), c));

Categoria încărcată e gestionată de sesiune, iar fără cascadă nu se încearcă inserarea ei.

2Setezi id-ul unei entități noi cu @GeneratedValue

Greșit
JAVA
Produs p = new Produs("Mouse");
p.setId(10L);
entityManager.persist(p);
Corect
JAVA
Produs p = new Produs("Mouse");
entityManager.persist(p); // id-ul vine de la bază

Un id setat face entitatea să pară deja existentă.

Repară tu

Repară eroarea, direct în pagină

POST /produse primește id-ul categoriei, construiește un obiect Categorie nou și îl leagă de produs, iar relația are cascade = CascadeType.ALL. În aplicația reală asta dă detached entity passed to persist. Încarcă categoria cu findById și scoate cascada de pe @ManyToOne.

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 = "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(cascade = CascadeType.ALL)
    @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> {
}

record ProdusNou(String nume, long categorieId) { }

@RestController
class ProdusController {
    private final ProdusRepository produse;
    private final CategorieRepository categorii;

    ProdusController(ProdusRepository produse, CategorieRepository categorii) {
        this.produse = produse;
        this.categorii = categorii;
    }

    @PostMapping("/produse")
    String adauga(@RequestBody ProdusNou p) {
        Categorie c = new Categorie("?");
        Produs salvat = produse.save(new Produs(p.nume(), c));
        return salvat.getNume() + " în categoria " + salvat.getCategorie().getNume() + ", categorii: " + categorii.count();
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
POST /produse → 200
Webcam în categoria Periferice, categorii: 2
Indiciu

Categoria există deja în bază: cere-o de la repository.

Alte forme ale mesajului

  • org.hibernate.PersistentObjectException: detached entity passed to persist: com.magazin.model.Categorie
  • jakarta.persistence.EntityExistsException: detached entity passed to persist
  • org.springframework.dao.InvalidDataAccessApiUsageException: detached entity passed to persist: Categorie

Cum o eviți pe viitor

  • Nu pune cascade pe @ManyToOne: entitatea „unu” trăiește independent.
  • Când primești un id de relație în DTO, încarcă entitatea cu findById (sau getReferenceById în tranzacție).
  • Nu seta manual id-uri pe entități cu @GeneratedValue.
  • Folosește save din Spring Data în loc de persist direct.

Întrebări frecvente

Care e diferența dintre persist și merge?

persist face un obiect nou gestionat și îl inserează; merge copiază starea unui obiect (nou sau detașat) peste rândul existent și întoarce copia gestionată.

Laboratorul nu dă eroarea. De ce?

Simulatorul din browser nu urmărește stările entităților. În aplicația reală, varianta inițială pică exact cu acest mesaj.

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.