...
Eroare Spring Boot · Spring Data JPA: entități și baza de date

ids for this class must be manually assigned before calling save(): Produs

Pe scurt

Entitatea are @Id fără @GeneratedValue, deci Hibernate așteaptă ca tu să setezi id-ul. L-ai lăsat null și ai apelat save(). Adaugă @GeneratedValue pe id (dacă baza trebuie să-l genereze) sau setează id-ul înainte de salvare.

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

Ce înseamnă

Când pui doar @Id pe un câmp, Hibernate folosește strategia „assigned”: valoarea cheii primare o dă aplicația. La persist, verifică dacă id-ul este setat; dacă e null, aruncă IdentifierGenerationException: ids for this class must be manually assigned before calling save(): Produs. Spring o traduce în JpaSystemException, iar clientul vede 500.

Mesajul numește entitatea (cu pachetul, în aplicațiile reale). De obicei e o scăpare: ai copiat @Id și ai uitat @GeneratedValue. Uneori e intenționat (coduri ca "RO", ISBN-uri, UUID-uri generate în cod), iar atunci trebuie doar să setezi valoarea înainte de save.

Atenție la combinația inversă: cu id atribuit manual, save() pe un id deja existent nu inserează, ci actualizează rândul (Spring Data apelează merge), ceea ce poate suprascrie date fără să-ți dai seama.

De ce apare: cauzele frecvente

1Ai uitat @GeneratedValue

Greșit
JAVA
@Id
private Long id;
Corect
JAVA
@Id
@GeneratedValue
private Long id;

Cu @GeneratedValue, baza (sau o secvență) generează id-ul la save.

2Id-ul e un cod de business pe care nu-l setezi

Greșit
JAVA
@Id
private String isbn;
...
repo.save(new Carte("Ion"));
Corect
JAVA
@Id
private String isbn;
...
repo.save(new Carte("978-973-46-0001-2", "Ion"));

O cheie naturală trebuie primită de la client sau calculată înainte de salvare.

Repară tu

Repară eroarea, direct în pagină

POST /clienti dă 500 cu ids for this class must be manually assigned before calling save(): Client. Fă ca id-ul clientului să fie generat automat la salvare, ca fiecare client nou să primească id-ul următor.

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 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 Client {
    @Id
    private Long id;
    private String nume;

    protected Client() {
    }

    Client(String nume) {
        this.nume = nume;
    }

    public Long getId() { return id; }
    public String getNume() { return nume; }
}

interface ClientRepository extends JpaRepository<Client, Long> {
}

@RestController
class ClientController {
    private final ClientRepository repo;

    ClientController(ClientRepository repo) {
        this.repo = repo;
    }

    @PostMapping("/clienti")
    Client adauga(@RequestParam String nume) {
        return repo.save(new Client(nume));
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
POST /clienti?nume=Ioana → 200
{"id":1,"nume":"Ioana"}
POST /clienti?nume=Radu → 200
{"id":2,"nume":"Radu"}
Indiciu

Câmpul are @Id, dar nimic nu-i spune lui Hibernate să genereze valoarea.

Alte forme ale mesajului

  • org.hibernate.id.IdentifierGenerationException: ids for this class must be manually assigned before calling save(): com.magazin.model.Produs
  • Identifier of entity 'Produs' must be manually assigned before calling 'persist()'

Cum o eviți pe viitor

  • Pentru id-uri tehnice (Long), pune mereu perechea @Id @GeneratedValue.
  • Pentru chei naturale (cod, ISBN), cere valoarea în DTO și valideaz-o cu @NotBlank.
  • Nu seta manual id-uri pe entitățile cu @GeneratedValue: amestecul duce la conflicte de chei.
  • Un test care salvează o entitate nouă prinde imediat lipsa generatorului.

Întrebări frecvente

Ce strategie de generare să aleg?

Implicit (AUTO) e bine pentru început. În producție, cu PostgreSQL, SEQUENCE e eficientă; cu MySQL se folosește IDENTITY. Important e să nu amesteci id-uri generate cu id-uri puse de mână.

Pot folosi UUID ca id?

Da: @Id @GeneratedValue(strategy = GenerationType.UUID) UUID id; în Hibernate 6, sau un UUID generat în constructor. Avantajul: id-ul există înainte de salvare.

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.