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

Not a managed type: class Produs

Pe scurt

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ă

Greșit
JAVA
class Produs {
    @Id @GeneratedValue
    Long id;
    String nume;
}
Corect
JAVA
@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

Greșit
JAVA
import javax.persistence.Entity; // Spring Boot 3

@Entity
class Produs { ... }
Corect
JAVA
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

Greșit
JAVA
package com.magazin.app;      // @SpringBootApplication aici
package com.magazin.model;    // Produs aici: frate, nu copil
Corect
JAVA
package com.magazin;          // @SpringBootApplication aici
package com.magazin.model;    // Produs: subpachet, e scanat

Spring Boot caută entități doar sub pachetul aplicației. Mută clasa principală mai sus sau folosește @EntityScan("com.magazin.model").

Repară tu

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.

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);
    }
}

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

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: Not a managed type: class com.magazin.model.Produs
  • Error 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 @Id pe 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

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