detached entity passed to persist: Categorie
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
@ManyToOne(cascade = CascadeType.ALL)
private Categorie categorie;
...
Categorie c = new Categorie();
c.setId(dto.categorieId());
repo.save(new Produs(dto.nume(), c));@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
Produs p = new Produs("Mouse");
p.setId(10L);
entityManager.persist(p);Produs p = new Produs("Mouse");
entityManager.persist(p); // id-ul vine de la bazăUn id setat face entitatea să pară deja existentă.
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.
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();
}
}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.
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> {
}
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 = categorii.findById(p.categorieId()).orElseThrow();
Produs salvat = produse.save(new Produs(p.nume(), c));
return salvat.getNume() + " în categoria " + salvat.getCategorie().getNume() + ", categorii: " + categorii.count();
}
}De ce merge
Categoria cu id-ul 1 există deja, deci nu trebuie creată, ci încărcată. findById întoarce obiectul gestionat, iar produsul nou se leagă de el. Fără cascadă pe @ManyToOne, salvarea produsului nu mai încearcă să insereze sau să modifice categoria. În simulator, varianta inițială crea o categorie nouă „?”: vezi diferența la numărul de categorii.
Alte forme ale mesajului
org.hibernate.PersistentObjectException: detached entity passed to persist: com.magazin.model.Categoriejakarta.persistence.EntityExistsException: detached entity passed to persistorg.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(saugetReferenceByIdîn tranzacție). - Nu seta manual id-uri pe entități cu
@GeneratedValue. - Folosește
savedin Spring Data în loc depersistdirect.
Î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
object references an unsaved transient instance - save the transient instance before flushing: Produs.categorie -> Categorie Salvezi o entitate care trimite (printr-o relație) la alt obiect încă nesalvat, creat cu new. Hibernate nu poate scrie cheia străină pentru un rând care nu există. Salvează întâi obiectul legat (sau încarcă-l din bază), ori pune cascade pe relație dacă părintele îl deține. 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). Î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.
