Failed to instantiate [CursValutar]: Factory method 'cursValutar' threw exception with message: Cursul trebuie să fie pozitiv
O metodă @Bean (metoda „fabrică”) a aruncat o excepție când Spring a apelat-o, deci bean-ul nu s-a creat și aplicația s-a oprit. Mesajul de după „with message” spune motivul: repară datele sau configurarea folosite în metodă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare metodă @Bean dintr-o clasă @Configuration este o fabrică: Spring o apelează o dată la pornire și păstrează obiectul întors. Dacă metoda aruncă o excepție, Spring o împachetează în BeanCreationException cu textul Failed to instantiate [Tip]: Factory method 'numeMetoda' threw exception with message: ... (în Boot 3; versiunile vechi scriu nested exception is ...).
[CursValutar] este tipul întors, 'cursValutar' este numele metodei (și al bean-ului), iar textul de la final este mesajul excepției aruncate. De multe ori metoda primește proprietăți (@Value) sau alte bean-uri ca parametri, iar una dintre ele are o valoare greșită: o proprietate goală, un număr negativ, o adresă invalidă.
Caută metoda cu numele din mesaj și verifică valorile cu care a fost apelată.
De ce apare: cauzele frecvente
1Proprietatea primită are o valoare greșită
app.curs-eur=-4.97
@Bean
CursValutar cursValutar(@Value("${app.curs-eur}") double curs) {
return new CursValutar(curs); // aruncă pentru curs negativ
}app.curs-eur=4.97Constructorul validează valoarea și aruncă excepția. Corectează configurarea, nu validarea.
2Metoda face o operație care poate eșua
@Bean
Catalog catalog() {
return Catalog.din(URI.create("localhost:9000 /x"));
}@Bean
Catalog catalog() {
return Catalog.din(URI.create("http://localhost:9000/x"));
}O adresă invalidă aruncă IllegalArgumentException chiar la crearea bean-ului.
Repară eroarea, direct în pagină
Metoda @Bean cursValutar aruncă o excepție la pornire: primește cursul 0, deși application.properties conține app.curs.eur=4.97. Găsește de ce valoarea nu ajunge în metodă și repar-o, ca GET /conversie?lei=497 să răspundă 100.0 EUR.
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.context.annotation.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
class CursValutar {
private final double eur;
CursValutar(double eur) {
if (eur <= 0) {
throw new IllegalArgumentException("Cursul trebuie să fie pozitiv, primit: " + eur);
}
this.eur = eur;
}
double inEuro(double lei) {
return Math.round(lei / eur * 100) / 100.0;
}
}
@Configuration
class ValutaConfig {
@Bean
CursValutar cursValutar(@Value("${app.curs-eur:0}") double curs) {
return new CursValutar(curs);
}
}
@RestController
class ConversieController {
private final CursValutar curs;
ConversieController(CursValutar curs) {
this.curs = curs;
}
@GetMapping("/conversie")
String conversie(@RequestParam double lei) {
return curs.inEuro(lei) + " EUR";
}
}Tomcat started on port 8080 (http) Started Application GET /conversie?lei=497 → 200 100.0 EUR
Indiciu
Compară cheia din @Value cu cea din application.properties, caracter cu caracter.
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.context.annotation.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
class CursValutar {
private final double eur;
CursValutar(double eur) {
if (eur <= 0) {
throw new IllegalArgumentException("Cursul trebuie să fie pozitiv, primit: " + eur);
}
this.eur = eur;
}
double inEuro(double lei) {
return Math.round(lei / eur * 100) / 100.0;
}
}
@Configuration
class ValutaConfig {
@Bean
CursValutar cursValutar(@Value("${app.curs.eur:0}") double curs) {
return new CursValutar(curs);
}
}
@RestController
class ConversieController {
private final CursValutar curs;
ConversieController(CursValutar curs) {
this.curs = curs;
}
@GetMapping("/conversie")
String conversie(@RequestParam double lei) {
return curs.inEuro(lei) + " EUR";
}
}De ce merge
@Value("${app.curs-eur:0}") căuta cheia app.curs-eur, care nu există (în fișier e app.curs.eur), așa că folosea valoarea implicită 0. Constructorul a respins-o, iar excepția din metoda fabrică a oprit pornirea. Cu cheia corectă, metoda primește 4.97 și întoarce bean-ul. Lecția: o valoare implicită ascunde o cheie greșită; validarea din constructor a făcut problema vizibilă imediat, nu prin conversii greșite în producție.
Alte forme ale mesajului
Error creating bean with name 'cursValutar' defined in class path resource [ValutaConfig.class]: Failed to instantiate [CursValutar]: Factory method 'cursValutar' threw exception; nested exception is java.lang.IllegalArgumentException
Cum o eviți pe viitor
- Validează configurarea aproape de sursă, cu
@ConfigurationPropertiesși@Validated, ca mesajul să spună direct proprietatea greșită. - Ține metodele
@Beansimple: creează și configurează obiectul, fără apeluri de rețea. - Dă mesaje clare excepțiilor aruncate de constructori, cu valoarea primită.
Întrebări frecvente
Unde e definit bean-ul din mesaj?
Mesajul lung indică și clasa: defined in class path resource [ValutaConfig.class]. Caută acolo metoda cu numele dat.
De ce nu văd numele proprietății?
Pentru că Spring vede doar excepția aruncată de metoda ta. Pune valoarea primită în mesajul excepției ca să o recunoști imediat.
Erori înrudite
BeanCreationException: Error creating bean with name 'catalogService': Invocation of init method failed Metoda de inițializare a unui bean (de obicei cea cu @PostConstruct) a aruncat o excepție, așa că Spring nu a putut termina crearea lui și oprește aplicația. Citește cauza din Caused by și fă inițializarea să trateze cazul respectiv. Parameter 0 of constructor in CatalogClient required a bean of type 'org.springframework.web.client.RestTemplate' that could not be found. Spring Boot nu creează automat un RestTemplate, ci doar un RestTemplateBuilder. Declară o metodă @Bean care întoarce RestTemplate (de exemplu builder.build()) într-o clasă @Configuration, apoi injectează-l. 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. Î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.
