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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Hibernate împarte obiectele în stări: transient (creat cu new, necunoscut bazei), gestionat, detașat. Când salvezi un Produs al cărui câmp categorie arată către o Categorie transientă, Hibernate ar trebui să scrie în produs.categorie_id id-ul unei categorii care nu există încă. Nu face presupuneri, ci se oprește la flush cu TransientPropertyValueException: object references an unsaved transient instance - save the transient instance before flushing : Produs.categorie -> Categorie.
Mesajul îți dă relația exactă (Produs.categorie) și tipul obiectului nesalvat (Categorie). Eroarea apare la save, la flush sau la finalul tranzacției, uneori sub forma InvalidDataAccessApiUsageException.
Întrebarea de design este cine deține ciclul de viață al obiectului legat: o categorie există independent, deci o încarci sau o salvezi separat; liniile unei comenzi aparțin comenzii, deci cascada e potrivită acolo.
De ce apare: cauzele frecvente
1Categoria e creată cu new și nesalvată
Categorie c = new Categorie("Birou");
produsRepo.save(new Produs("Lampă", c));Categorie c = categorieRepo.save(new Categorie("Birou"));
produsRepo.save(new Produs("Lampă", c));Obiectul întors de save are id, deci cheia străină poate fi scrisă.
2Ar trebui să folosești o categorie existentă
Categorie c = new Categorie();
c.setId(dto.categorieId()); // obiect nou, doar cu idCategorie c = categorieRepo.findById(dto.categorieId())
.orElseThrow();Încarci categoria reală din bază, nu fabrici un obiect cu același id.
3Copiii aparțin părintelui, dar lipsește cascada
@OneToMany(mappedBy = "comanda")
List<LinieComanda> linii;@OneToMany(mappedBy = "comanda", cascade = CascadeType.ALL, orphanRemoval = true)
List<LinieComanda> linii;Cu cascadă, save(comanda) salvează și liniile noi.
Repară eroarea, direct în pagină
POST /produse creează produsul cu o categorie nouă, nesalvată, iar Hibernate dă object references an unsaved transient instance. Salvează întâi categoria cu CategorieRepository, apoi produsul legat de categoria salvată.
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, String categorie) { }
@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(p.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 Lampă în categoria Birou, categorii: 1
Indiciu
Folosește obiectul întors de categorii.save(...) când creezi produsul.
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, String categorie) { }
@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.save(new Categorie(p.categorie()));
Produs salvat = produse.save(new Produs(p.nume(), c));
return salvat.getNume() + " în categoria " + salvat.getCategorie().getNume() + ", categorii: " + categorii.count();
}
}De ce merge
Produsul trimitea la o categorie care nu exista în bază, deci Hibernate nu avea ce id să scrie în categorie_id. Acum categoria se salvează întâi, iar produsul primește obiectul întors de save, care are id. Ordinea contează: întâi părintele independent, apoi entitatea care îl referă.
Alte forme ale mesajului
org.hibernate.TransientPropertyValueException: object references an unsaved transient instance - save the transient instance before flushing : Produs.categorie -> Categorieorg.hibernate.TransientObjectException: object references an unsaved transient instance - save the transient instance before flushing: CategorieNot-null property references a transient value - transient instance must be saved before current operation
Cum o eviți pe viitor
- Pentru relații către entități independente (categorie, client), încarcă obiectul din bază după id.
- Pune
cascadedoar dinspre părinte spre copiii pe care îi deține (comandă către linii), nu pe@ManyToOne. - Folosește mereu obiectul întors de
save. - Scrie un test care creează relația și citește înapoi cheia străină.
Întrebări frecvente
De ce nu pun cascade = ALL pe @ManyToOne și gata?
Pentru că atunci ștergerea sau salvarea unui produs ar acționa și asupra categoriei, folosită de alte produse. Cascada pe @ManyToOne produce ștergeri și duplicate neintenționate.
Laboratorul salvează fără eroare. De ce?
Simulatorul ține relațiile ca referințe Java și nu verifică starea obiectelor. Hibernate o verifică, deci în proiect codul inițial pică.
Erori înrudite
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. 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.
