Not a managed type: class Produs
Spring Data a primit un repository pentru o clasă pe care JPA nu o cunoaște ca entitate. Aproape mereu lipsește @Entity pe clasa Produs sau clasa e în afara pachetelor scanate. Pune @Entity (jakarta.persistence) pe clasă și verifică pachetul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul apare la pornire, când Spring Data JPA creează implementarea pentru ProdusRepository extends JpaRepository<Produs, Long>. Ca să facă asta, cere de la JPA (Hibernate) metamodelul clasei Produs. Dacă Hibernate nu a înregistrat clasa ca entitate, răspunde cu IllegalArgumentException: Not a managed type: class Produs, iar Spring o împachetează în BeanCreationException: Error creating bean with name 'produsRepository'.
„Managed type” înseamnă o clasă pe care JPA o gestionează: are @Entity (sau @Embeddable) și se află într-un pachet pe care Spring Boot îl scanează pentru entități (pachetul clasei cu @SpringBootApplication și subpachetele lui).
În stiva de apeluri caută întâi rândul Caused by: java.lang.IllegalArgumentException: Not a managed type: numele clasei din mesaj îți spune exact ce entitate are problema. Restul liniilor (UnsatisfiedDependencyException pentru controller și service) sunt doar consecințe.
De ce apare: cauzele frecvente
1Lipsește @Entity pe clasă
class Produs {
@Id @GeneratedValue
Long id;
String nume;
}@Entity
class Produs {
@Id @GeneratedValue
Long id;
String nume;
}Fără @Entity, Hibernate nu creează tabelă și nu știe nimic despre clasă, deci repository-ul nu are ce gestiona.
2Ai importat @Entity din pachetul greșit
import javax.persistence.Entity; // Spring Boot 3
@Entity
class Produs { ... }import jakarta.persistence.Entity;
@Entity
class Produs { ... }Spring Boot 3 folosește Jakarta Persistence. O adnotare din javax.persistence (rămasă dintr-un tutorial vechi) nu este recunoscută de Hibernate 6.
3Entitatea stă în afara pachetelor scanate
package com.magazin.app; // @SpringBootApplication aici
package com.magazin.model; // Produs aici: frate, nu copilpackage com.magazin; // @SpringBootApplication aici
package com.magazin.model; // Produs: subpachet, e scanatSpring Boot caută entități doar sub pachetul aplicației. Mută clasa principală mai sus sau folosește @EntityScan("com.magazin.model").
Repară eroarea, direct în pagină
Aplicația nu pornește și dă Not a managed type: class Produs. Fă din Produs o entitate JPA, ca GET /produse să întoarcă lista produselor din data.sql.
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);
}
}
class Produs {
@Id
@GeneratedValue
private Long id;
private String nume;
protected Produs() {
}
public Long getId() { return id; }
public String getNume() { return nume; }
}
interface ProdusRepository extends JpaRepository<Produs, Long> {
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse")
List<Produs> toate() {
return repo.findAll();
}
}Tomcat started on port 8080 (http)
Started Application
GET /produse → 200
[{"id":1,"nume":"Mouse"},{"id":2,"nume":"Tastatură"}]Indiciu
Uită-te la adnotările clasei Produs: îi lipsește exact una.
Reparația
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 Produs {
@Id
@GeneratedValue
private Long id;
private String nume;
protected Produs() {
}
public Long getId() { return id; }
public String getNume() { return nume; }
}
interface ProdusRepository extends JpaRepository<Produs, Long> {
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse")
List<Produs> toate() {
return repo.findAll();
}
}De ce merge
JpaRepository<Produs, Long> poate fi creat doar pentru o clasă gestionată de JPA. Cu @Entity, Hibernate înregistrează clasa, creează tabela produs, iar data.sql are unde insera rândurile. Câmpul cu @Id era deja acolo, la fel constructorul fără argumente cerut de JPA: lipsea doar marcajul de entitate.
Alte forme ale mesajului
java.lang.IllegalArgumentException: Not a managed type: class com.magazin.model.ProdusError creating bean with name 'produsRepository' defined in ProdusRepository defined in @EnableJpaRepositories declared on Application: Not a managed type: class Produs
Cum o eviți pe viitor
- Pune
@Entityși@Idpe fiecare clasă pe care o salvezi cu un repository. - Importă adnotările din
jakarta.persistenceîn Spring Boot 3. - Ține clasa cu
@SpringBootApplicationîn pachetul rădăcină, iar entitățile, repository-urile și controllerele în subpachete. - Când vezi un lanț lung de excepții la pornire, citește ultimul
Caused by.
Întrebări frecvente
De ce eroarea pomenește repository-ul, nu entitatea?
Pentru că problema se descoperă când Spring construiește repository-ul. Entitatea fără @Entity e o clasă obișnuită, validă pentru Java; abia repository-ul cere ca ea să fie gestionată de JPA.
Am pus @Entity și tot primesc eroarea. Ce mai verific?
Importul (jakarta.persistence.Entity, nu javax), pachetul clasei față de clasa principală și dacă nu ai cumva două clase Produs în pachete diferite, iar repository-ul o folosește pe cea greșită.
Erori înrudite
No identifier specified for entity: Produs 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. No default (no-argument) constructor for class: Produs (class must be instantiated by Hibernate) Hibernate creează obiectele entității când citește rânduri din bază și are nevoie de un constructor fără argumente. Clasa ta are doar constructori cu parametri. Adaugă un constructor fără argumente (poate fi protected) lângă cel cu parametri. Table "PRODUSE" not found Un script SQL (de obicei data.sql) folosește o tabelă care nu există în baza de date. Fie numele e greșit (tabela entității Produs se numește produs), fie scriptul rulează înainte ca Hibernate să creeze tabelele: pune spring.jpa.defer-datasource-initialization=true. Î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.
