...
Eroare Spring Boot · Configurare, proprietăți și profiluri

Not registered via @EnableConfigurationProperties, marked as Spring component, or scanned via @ConfigurationPropertiesScan

Pe scurt

Clasa @ConfigurationProperties nu este înregistrată ca bean, deci nu poate fi injectată (la pornire vezi „required a bean of type ... that could not be found”). Adaugă @EnableConfigurationProperties(Clasa.class) sau @ConfigurationPropertiesScan pe clasa aplicației.

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

Ce înseamnă

Mesajul îl afișează IntelliJ IDEA pe o clasă @ConfigurationProperties care nu e înregistrată. Adnotarea @ConfigurationProperties(prefix = "app.livrare") spune doar cum se leagă proprietățile, nu creează un bean. Ca Spring să creeze obiectul, clasa trebuie înregistrată într-unul din trei moduri:

  • @EnableConfigurationProperties(LivrareProps.class) pe o clasă @Configuration sau pe clasa aplicației;
  • @ConfigurationPropertiesScan pe clasa aplicației (găsește toate clasele de proprietăți din pachet);
  • @Component pe clasa de proprietăți (merge doar pentru clase cu setter-e, nu pentru record-uri).

Fără înregistrare, aplicația nu pornește când injectezi clasa: Parameter 0 of constructor in LivrareController required a bean of type 'LivrareProps' that could not be found.

De ce apare: cauzele frecvente

1Lipsește înregistrarea

Greșit
JAVA
@ConfigurationProperties(prefix = "app.livrare")
record LivrareProps(int cost) { }
Corect
JAVA
@SpringBootApplication
@ConfigurationPropertiesScan
public class Application { ... }

Scanarea găsește și înregistrează toate clasele @ConfigurationProperties din pachet.

2@Component pe un record

Greșit
JAVA
@Component
@ConfigurationProperties(prefix = "app.livrare")
record LivrareProps(int cost) { }
Corect
JAVA
@ConfigurationProperties(prefix = "app.livrare")
record LivrareProps(int cost) { }
// + @EnableConfigurationProperties(LivrareProps.class)

Record-urile se leagă prin constructor, ceea ce cere înregistrarea prin @EnableConfigurationProperties sau scanare.

Repară tu

Repară eroarea, direct în pagină

LivrareProps leagă proprietățile app.livrare.*, dar aplicația nu pornește: controller-ul cere un bean LivrareProps care nu există. Înregistrează clasa de proprietăți, ca GET /livrare să răspundă Livrare 15 lei, gratuită peste 200 lei.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
import org.springframework.boot.context.properties.*;
import org.springframework.context.annotation.*;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

@ConfigurationProperties(prefix = "app.livrare")
record LivrareProps(int cost, int pragGratuit) {
}

@Configuration
class ConfigLivrare {
    // TODO: înregistrează LivrareProps
}

@RestController
class LivrareController {
    private final LivrareProps props;

    LivrareController(LivrareProps props) {
        this.props = props;
    }

    @GetMapping("/livrare")
    String livrare() {
        return "Livrare " + props.cost() + " lei, gratuită peste " + props.pragGratuit() + " lei";
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /livrare → 200
Livrare 15 lei, gratuită peste 200 lei
Indiciu

Adaugă @EnableConfigurationProperties(LivrareProps.class) pe clasa de configurare existentă.

Alte forme ale mesajului

  • Parameter 0 of constructor in LivrareController required a bean of type 'LivrareProps' that could not be found.

Cum o eviți pe viitor

  • Pune @ConfigurationPropertiesScan pe clasa aplicației o dată, la începutul proiectului.
  • Preferă record-uri pentru proprietăți: sunt imuabile și se leagă prin constructor.
  • Adaugă spring-boot-configuration-processor ca dependență opțională: IDE-ul îți completează cheile din application.properties.
  • Pornește aplicația după fiecare clasă de proprietăți nouă, ca o înregistrare uitată să se vadă imediat.

Întrebări frecvente

E o eroare de compilare?

Nu. E un avertisment din IDE; la rulare apare ca bean lipsă.

Pot pune @EnableConfigurationProperties pe clasa principală?

Da, clasa @SpringBootApplication este și ea o clasă de configurare.

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.