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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
După ce creează un bean și îi injectează dependențele, Spring apelează metoda de inițializare: cea marcată cu @PostConstruct, afterPropertiesSet() din InitializingBean sau initMethod din @Bean. Dacă metoda aruncă o excepție, crearea bean-ului eșuează cu BeanCreationException: ... Invocation of init method failed, iar sub ea apare Caused by: cu excepția reală (de exemplu IllegalStateException: Catalogul este gol).
Pentru că bean-urile se creează la pornire, o excepție aici înseamnă Application run failed și aplicația se oprește. Cauze tipice: încarci date dintr-o sursă care lipsește, validezi o configurare care e greșită, faci calcule pe colecții goale.
Uneori oprirea e exact ce vrei (configurare invalidă: e mai bine să nu pornești). Alteori, cazul e normal (catalog gol la prima rulare) și inițializarea trebuie să-l trateze.
De ce apare: cauzele frecvente
1Inițializarea nu tratează datele lipsă
@PostConstruct
void incarca() {
if (produse.isEmpty()) throw new IllegalStateException("Catalog gol");
}@PostConstruct
void incarca() {
if (produse.isEmpty()) log.warn("Catalogul este gol");
}Un catalog gol la prima pornire este normal; un avertisment e suficient. Excepția oprește toată aplicația.
2Folosești o valoare înainte să fie setată
@PostConstruct
void init() { limita = Integer.parseInt(textLimita); } // textLimita = ""@Value("${app.limita:10}") int limita;O conversie pe un text gol aruncă NumberFormatException. Lasă Spring să convertească proprietatea și dă-i o valoare implicită.
Repară eroarea, direct în pagină
Aplicația nu pornește: @PostConstruct din CatalogService aruncă o excepție când lista de produse e goală. Fă inițializarea să accepte un catalog gol, afișând Catalog gol la pornire cu System.out.println, ca GET /produse/numar să răspundă 0 produse.
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 jakarta.annotation.PostConstruct;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Service
class CatalogService {
private final List<String> produse = new ArrayList<>();
@PostConstruct
void verifica() {
if (produse.isEmpty()) {
throw new IllegalStateException("Catalogul este gol");
}
}
int numar() {
return produse.size();
}
}
@RestController
class CatalogController {
private final CatalogService service;
CatalogController(CatalogService service) {
this.service = service;
}
@GetMapping("/produse/numar")
String numar() {
return service.numar() + " produse";
}
}Catalog gol la pornire Tomcat started on port 8080 (http) Started Application GET /produse/numar → 200 0 produse
Indiciu
Înlocuiește throw cu un mesaj afișat.
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 jakarta.annotation.PostConstruct;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Service
class CatalogService {
private final List<String> produse = new ArrayList<>();
@PostConstruct
void verifica() {
if (produse.isEmpty()) {
System.out.println("Catalog gol la pornire");
}
}
int numar() {
return produse.size();
}
}
@RestController
class CatalogController {
private final CatalogService service;
CatalogController(CatalogService service) {
this.service = service;
}
@GetMapping("/produse/numar")
String numar() {
return service.numar() + " produse";
}
}De ce merge
Spring apelează metoda @PostConstruct imediat după ce creează CatalogService. Excepția aruncată acolo transforma un caz normal (catalog gol) într-o pornire eșuată: Invocation of init method failed. Acum metoda doar semnalează situația, iar mesajul apare în consolă înainte de Tomcat started, pentru că bean-urile se creează înaintea pornirii serverului. Păstrează excepțiile în inițializare doar pentru stări din care aplicația chiar nu poate funcționa.
Alte forme ale mesajului
Error creating bean with name 'catalogService': Invocation of init method failed; nested exception is java.lang.IllegalStateExceptionApplication run failed
Cum o eviți pe viitor
- Ține metodele
@PostConstructscurte și fără apeluri de rețea; pentru încărcări grele foloseșteApplicationRunner. - Hotărăște conștient: o configurare invalidă trebuie să oprească pornirea, dar un caz normal (date goale) nu.
- Loghează mesaje clare în inițializare, ca să știi ce lipsea.
- Pentru validarea proprietăților, folosește
@ConfigurationPropertiescu@Validated.
Întrebări frecvente
Unde văd excepția reală?
În stiva de apeluri, la ultimul Caused by:. Primul rând spune doar ce bean nu s-a putut crea.
E mai bine în @PostConstruct sau în CommandLineRunner?
@PostConstruct pregătește bean-ul însuși. Ce ține de aplicație (încărcare de date, apeluri externe) se pune mai bine într-un ApplicationRunner, care rulează după pornire.
Erori înrudite
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ă. Failed to instantiate [RaportService]: No default constructor found Clasa are mai mulți constructori și niciunul nu e marcat cu @Autowired, așa că Spring caută un constructor fără parametri, care nu există. Păstrează un singur constructor sau marchează-l cu @Autowired pe cel folosit pentru injectare. UnsatisfiedDependencyException: Error creating bean with name 'raportController': Unsatisfied dependency expressed through constructor parameter 0 Spring nu a putut crea bean-ul din mesaj pentru că una dintre dependențele lui (parametrul indicat) nu a putut fi rezolvată. Citește cauza din finalul stivei (No qualifying bean, alt bean care nu se creează) și repar-o acolo. Î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.
