Not registered via @EnableConfigurationProperties, marked as Spring component, or scanned via @ConfigurationPropertiesScan
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ă@Configurationsau pe clasa aplicației;@ConfigurationPropertiesScanpe clasa aplicației (găsește toate clasele de proprietăți din pachet);@Componentpe 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
@ConfigurationProperties(prefix = "app.livrare")
record LivrareProps(int cost) { }@SpringBootApplication
@ConfigurationPropertiesScan
public class Application { ... }Scanarea găsește și înregistrează toate clasele @ConfigurationProperties din pachet.
2@Component pe un record
@Component
@ConfigurationProperties(prefix = "app.livrare")
record LivrareProps(int cost) { }@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ă 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.
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";
}
}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ă.
Reparația
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
@EnableConfigurationProperties(LivrareProps.class)
class ConfigLivrare {
}
@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";
}
}De ce merge
@ConfigurationProperties descrie legarea, dar nu creează bean-ul. @EnableConfigurationProperties(LivrareProps.class) îi cere lui Spring să creeze un LivrareProps, legând app.livrare.cost și app.livrare.prag-gratuit (forma kebab-case devine pragGratuit). Acum controller-ul primește obiectul în constructor. Alternativ, @ConfigurationPropertiesScan pe clasa aplicației le înregistrează pe toate deodată.
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
@ConfigurationPropertiesScanpe 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-processorca dependență opțională: IDE-ul îți completează cheile dinapplication.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
Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'app.paginare' to PaginareProps failed O clasă @ConfigurationProperties marcată cu @Validated a primit din configurare o valoare care încalcă o regulă (@Min, @Max, @NotBlank). Mesajul arată proprietatea, valoarea și motivul (Reason): corectează valoarea din application.properties. Field produsService in ProdusController required a bean of type 'ProdusService' that could not be found. Spring a încercat să injecteze câmpul marcat cu @Autowired, dar nu există niciun bean de tipul cerut. De obicei clasa nu are @Service / @Component sau stă în afara pachetului scanat. Adaugă adnotarea pe clasă (sau un @Bean) și aplicația pornește. Failed to bind properties under 'app.plati.timeout' to java.time.Duration Valoarea unei proprietăți legate cu @ConfigurationProperties nu se poate converti în tipul câmpului, aici o durată. Duration acceptă formatele 10s, 500ms, 2m, 1h sau ISO-8601 (PT10S), nu „10 sec”. Corectează valoarea din configurare. Î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.
