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

object references an unsaved transient instance - save the transient instance before flushing: Produs.categorie -> Categorie

Pe scurt

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ă

Greșit
JAVA
Categorie c = new Categorie("Birou");
produsRepo.save(new Produs("Lampă", c));
Corect
JAVA
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ă

Greșit
JAVA
Categorie c = new Categorie();
c.setId(dto.categorieId()); // obiect nou, doar cu id
Corect
JAVA
Categorie 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

Greșit
JAVA
@OneToMany(mappedBy = "comanda")
List<LinieComanda> linii;
Corect
JAVA
@OneToMany(mappedBy = "comanda", cascade = CascadeType.ALL, orphanRemoval = true)
List<LinieComanda> linii;

Cu cascadă, save(comanda) salvează și liniile noi.

Repară tu

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

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

Alte forme ale mesajului

  • org.hibernate.TransientPropertyValueException: object references an unsaved transient instance - save the transient instance before flushing : Produs.categorie -> Categorie
  • org.hibernate.TransientObjectException: object references an unsaved transient instance - save the transient instance before flushing: Categorie
  • Not-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 cascade doar 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

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