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

No default (no-argument) constructor for class: Produs (class must be instantiated by Hibernate)

Pe scurt

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

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

Greșit
JAVA
@Entity
record Produs(@Id Long id, String nume) { }
Corect
JAVA
@Entity
class Produs { ... }       // entitatea
record ProdusDto(Long id, String nume) { } // pentru API

Record-urile nu au constructor fără argumente și nu pot fi modificate; folosește-le pentru DTO-uri.

3Constructorul fără argumente este private

Greșit
JAVA
@Entity
class Produs {
    private Produs() { }
}
Corect
JAVA
@Entity
class Produs {
    protected Produs() { }
}

Specificația cere public sau protected; proxy-urile Hibernate au nevoie să-l poată apela din subclase.

Repară tu

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.

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

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.Produs
  • Class 'Produs' should have [public, protected] no-arg constructor

Cum o eviți pe viitor

  • Pornește fiecare entitate cu un constructor protected fă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

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