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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
JPA cere ca orice entitate să aibă un constructor fără argumente, public sau protected. Motivul: când Hibernate citește un rând, întâi creează obiectul gol (new Produs(), prin reflection), apoi completează câmpurile din coloane. Dacă ai scris doar Produs(String nume, int pret), compilatorul Java nu mai generează constructorul implicit, iar Hibernate 6 aruncă InstantiationException: No default (no-argument) constructor for class: Produs (class must be instantiated by Hibernate).
Eroarea poate apărea la pornire sau abia prima dată când citești din bază (findAll, findById), adică la o cerere GET, ca 500. De aceea pare că „salvarea merge, citirea nu”.
Tot de aici vine și regula că entitățile nu sunt record-uri: un record nu are constructor fără argumente și are câmpuri final, deci nu poate fi entitate JPA (dar e perfect ca DTO).
De ce apare: cauzele frecvente
1Ai scris doar constructorul cu parametri
@Entity
class Produs {
@Id @GeneratedValue Long id;
String nume;
Produs(String nume) { this.nume = nume; }
}@Entity
class Produs {
@Id @GeneratedValue Long id;
String nume;
protected Produs() { }
Produs(String nume) { this.nume = nume; }
}Constructorul protected e pentru Hibernate; cel cu parametri rămâne pentru codul tău.
2Ai făcut entitatea record
@Entity
record Produs(@Id Long id, String nume) { }@Entity
class Produs { ... } // entitatea
record ProdusDto(Long id, String nume) { } // pentru APIRecord-urile nu au constructor fără argumente și nu pot fi modificate; folosește-le pentru DTO-uri.
3Constructorul fără argumente este private
@Entity
class Produs {
private Produs() { }
}@Entity
class Produs {
protected Produs() { }
}Specificația cere public sau protected; proxy-urile Hibernate au nevoie să-l poată apela din subclase.
Repară eroarea, direct în pagină
În proiectul real, GET /furnizori dă 500 cu No default (no-argument) constructor for class: Furnizor. Adaugă constructorul cerut de JPA, fără să ștergi constructorul cu parametri folosit la salvare.
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 Furnizor {
@Id
@GeneratedValue
private Long id;
private String nume;
private String oras;
Furnizor(String nume, String oras) {
this.nume = nume;
this.oras = oras;
}
public Long getId() { return id; }
public String getNume() { return nume; }
public String getOras() { return oras; }
}
interface FurnizorRepository extends JpaRepository<Furnizor, Long> {
}
@RestController
class FurnizorController {
private final FurnizorRepository repo;
FurnizorController(FurnizorRepository repo) {
this.repo = repo;
}
@PostMapping("/furnizori")
Furnizor adauga(@RequestParam String nume, @RequestParam String oras) {
return repo.save(new Furnizor(nume, oras));
}
@GetMapping("/furnizori")
List<Furnizor> toti() {
return repo.findAll();
}
}Tomcat started on port 8080 (http)
Started Application
POST /furnizori?nume=Tehno&oras=Cluj → 200
{"id":1,"nume":"Tehno","oras":"Cluj"}
GET /furnizori → 200
[{"id":1,"nume":"Tehno","oras":"Cluj"}]Indiciu
Un constructor fără argumente, cu vizibilitate protected.
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 Furnizor {
@Id
@GeneratedValue
private Long id;
private String nume;
private String oras;
protected Furnizor() {
}
Furnizor(String nume, String oras) {
this.nume = nume;
this.oras = oras;
}
public Long getId() { return id; }
public String getNume() { return nume; }
public String getOras() { return oras; }
}
interface FurnizorRepository extends JpaRepository<Furnizor, Long> {
}
@RestController
class FurnizorController {
private final FurnizorRepository repo;
FurnizorController(FurnizorRepository repo) {
this.repo = repo;
}
@PostMapping("/furnizori")
Furnizor adauga(@RequestParam String nume, @RequestParam String oras) {
return repo.save(new Furnizor(nume, oras));
}
@GetMapping("/furnizori")
List<Furnizor> toti() {
return repo.findAll();
}
}De ce merge
Când citește rândurile pentru findAll, Hibernate creează întâi un Furnizor gol, apoi îi completează câmpurile. Fără constructorul fără argumente nu are cum, deci citirea pica. Constructorul protected îi ajunge lui Hibernate, iar codul tău folosește în continuare constructorul cu parametri. Simulatorul nu verifică regula, dar proiectul real o cere.
Alte forme ale mesajului
org.hibernate.InstantiationException: No default (no-argument) constructor for class: Produs (class must be instantiated by Hibernate)No default constructor for entity: : com.magazin.model.ProdusClass 'Produs' should have [public, protected] no-arg constructor
Cum o eviți pe viitor
- Pornește fiecare entitate cu un constructor
protectedfără argumente. - Păstrează record-urile pentru DTO-uri, nu pentru entități.
- Dacă folosești Kotlin, adaugă pluginul
kotlin-jpa(no-arg). - Un test care salvează și apoi citește entitatea prinde eroarea înainte de producție.
Întrebări frecvente
De ce protected și nu public?
Ca restul codului să folosească doar constructorul cu parametri, care lasă obiectul complet. JPA acceptă și protected.
Laboratorul pornește fără eroare. De ce?
Simulatorul din browser nu folosește reflection și nu verifică regula. În proiectul real, Hibernate aruncă excepția prima dată când citește entitatea din bază.
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. 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. Î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.
