...
Eroare Spring Boot · Aplicația nu pornește: bean-uri și injectare

BeanCreationException: Error creating bean with name 'catalogService': Invocation of init method failed

Pe scurt

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ă

Greșit
JAVA
@PostConstruct
void incarca() {
    if (produse.isEmpty()) throw new IllegalStateException("Catalog gol");
}
Corect
JAVA
@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ă

Greșit
JAVA
@PostConstruct
void init() { limita = Integer.parseInt(textLimita); } // textLimita = ""
Corect
JAVA
@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ă tu

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.

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

Alte forme ale mesajului

  • Error creating bean with name 'catalogService': Invocation of init method failed; nested exception is java.lang.IllegalStateException
  • Application run failed

Cum o eviți pe viitor

  • Ține metodele @PostConstruct scurte și fără apeluri de rețea; pentru încărcări grele folosește ApplicationRunner.
  • 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 @ConfigurationProperties cu @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

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