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

No identifier specified for entity: Produs

Pe scurt

Entitatea Produs nu are niciun câmp marcat cu @Id, iar JPA cere o cheie primară pentru fiecare entitate. Adaugă un câmp id cu @Id (de obicei Long, cu @GeneratedValue) și verifică să fie importat din jakarta.persistence.

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

Ce înseamnă

Hibernate validează entitățile la pornire. Fiecare clasă cu @Entity trebuie să aibă un identificator: câmpul care devine cheia primară a tabelei și după care JPA recunoaște rândurile (findById, merge, cache-ul primului nivel). Când nu găsește niciun @Id (nici pe câmp, nici pe getter, nici moștenit dintr-o clasă cu @MappedSuperclass), oprește crearea EntityManagerFactory cu org.hibernate.AnnotationException: No identifier specified for entity: Produs.

În jurnal vezi de obicei întâi Error creating bean with name 'entityManagerFactory', iar mai jos cauza. Numele din mesaj este al entității cu problema; dacă numele e complet calificat (com.magazin.model.Produs), știi exact fișierul.

Deseori câmpul există, dar adnotarea @Id vine din pachetul greșit, de exemplu org.springframework.data.annotation.Id (folosit de Spring Data pentru MongoDB sau JDBC), pe care Hibernate îl ignoră.

De ce apare: cauzele frecvente

1Ai uitat @Id

Greșit
JAVA
@Entity
class Produs {
    Long id;
    String nume;
}
Corect
JAVA
@Entity
class Produs {
    @Id
    @GeneratedValue
    Long id;
    String nume;
}

Un câmp numit id nu devine cheie primară doar prin nume; JPA are nevoie de @Id.

2@Id importat din Spring Data în loc de JPA

Greșit
JAVA
import org.springframework.data.annotation.Id;

@Entity
class Produs {
    @Id Long id;
}
Corect
JAVA
import jakarta.persistence.Id;

@Entity
class Produs {
    @Id Long id;
}

Hibernate citește doar adnotările Jakarta Persistence. IDE-ul propune uneori primul Id găsit, nu pe cel bun.

3Clasa de bază nu are @MappedSuperclass

Greșit
JAVA
class EntitateDeBaza {
    @Id @GeneratedValue Long id;
}
@Entity
class Produs extends EntitateDeBaza { }
Corect
JAVA
@MappedSuperclass
class EntitateDeBaza {
    @Id @GeneratedValue Long id;
}
@Entity
class Produs extends EntitateDeBaza { }

Câmpurile unei clase-părinte se mapează doar dacă ea este @MappedSuperclass (sau tot @Entity).

Repară tu

Repară eroarea, direct în pagină

Aplicația nu pornește și dă No identifier specified for entity: Comanda. Marchează cheia primară a entității, cu valori generate automat, ca POST /comenzi să salveze comanda și să-i întoarcă id-ul.

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 Comanda {
    private Long id;
    private String client;

    protected Comanda() {
    }

    Comanda(String client) {
        this.client = client;
    }

    public Long getId() { return id; }
    public String getClient() { return client; }
}

interface ComandaRepository extends JpaRepository<Comanda, Long> {
}

@RestController
class ComandaController {
    private final ComandaRepository repo;

    ComandaController(ComandaRepository repo) {
        this.repo = repo;
    }

    @PostMapping("/comenzi")
    Comanda plaseaza(@RequestParam String client) {
        return repo.save(new Comanda(client));
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
POST /comenzi?client=Ana → 200
{"id":1,"client":"Ana"}
POST /comenzi?client=Mihai → 200
{"id":2,"client":"Mihai"}
Indiciu

Câmpul id există deja: îi lipsesc adnotările care îl fac cheie primară generată.

Alte forme ale mesajului

  • org.hibernate.AnnotationException: No identifier specified for entity: com.magazin.model.Produs
  • Error creating bean with name 'entityManagerFactory' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: No identifier specified for entity: Produs

Cum o eviți pe viitor

  • Pornește fiecare entitate de la același șablon: @Entity, @Id @GeneratedValue Long id, constructor fără argumente.
  • Verifică importurile: tot ce ține de entitate vine din jakarta.persistence.
  • Dacă ai câmpuri comune (id, date de creare), pune-le într-o clasă @MappedSuperclass.

Întrebări frecvente

Pot folosi alt tip decât Long pentru id?

Da: Integer, UUID, String sau un tip compus cu @EmbeddedId. Cu @GeneratedValue se folosesc de obicei Long sau UUID; un id String îl atribui tu înainte de save.

Tabela mea nu are cheie primară. Ce fac?

JPA cere un identificator. Alege o coloană (sau o combinație) cu valori unice și mapeaz-o cu @Id sau @EmbeddedId; dacă nu există, adaugă o coloană id în tabelă.

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.