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

Failed to instantiate [CursValutar]: Factory method 'cursValutar' threw exception with message: Cursul trebuie să fie pozitiv

Pe scurt

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ă

Greșit
JAVA
app.curs-eur=-4.97

@Bean
CursValutar cursValutar(@Value("${app.curs-eur}") double curs) {
    return new CursValutar(curs); // aruncă pentru curs negativ
}
Corect
JAVA
app.curs-eur=4.97

Constructorul validează valoarea și aruncă excepția. Corectează configurarea, nu validarea.

2Metoda face o operație care poate eșua

Greșit
JAVA
@Bean
Catalog catalog() {
    return Catalog.din(URI.create("localhost:9000 /x"));
}
Corect
JAVA
@Bean
Catalog catalog() {
    return Catalog.din(URI.create("http://localhost:9000/x"));
}

O adresă invalidă aruncă IllegalArgumentException chiar la crearea bean-ului.

Repară tu

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.

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

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 @Bean simple: 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

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