NoSuchBeanDefinitionException: No qualifying bean of type 'Notificator' available
Ai cerut containerului un bean de un tip pentru care nu există niciunul (de obicei cu getBean sau în timpul injectării). Creează bean-ul (@Component, @Bean) sau verifică dacă e condiționat de un profil ori de o proprietate care nu e activă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
NoSuchBeanDefinitionException înseamnă: în ApplicationContext nu există niciun bean de tipul Notificator. Apare în două situații:
- la pornire, ca
Caused byal unei injectări eșuate (Spring Boot o rezumă carequired a bean of type ... that could not be found); - la rulare, când codul cere singur bean-ul:
context.getBean(Notificator.class). Atunci eroarea apare abia când se execută acel cod, de exemplu la o cerere HTTP, și clientul primește 500.
Textul poate continua cu expected at least 1 bean which qualifies as autowire candidate și cu adnotările punctului de injectare (@Qualifier cerut). Dacă ai cerut un nume anume, mesajul devine No bean named 'x' available. Verifică dacă clasa e bean, dacă e în pachetul scanat și dacă nu e condiționată (@Profile, @ConditionalOnProperty).
De ce apare: cauzele frecvente
1Ceri cu getBean un tip care nu e bean
interface Notificator { String trimite(String m); }
class NotificatorEmail implements Notificator { ... }
context.getBean(Notificator.class);@Component
class NotificatorEmail implements Notificator { ... }
context.getBean(Notificator.class);getBean caută doar în bean-urile create de Spring. O clasă fără adnotare nu este acolo.
2Bean-ul e creat doar condiționat
@Component
@ConditionalOnProperty(name = "app.email.activ", havingValue = "true")
class NotificatorEmail implements Notificator { }app.email.activ=trueFără proprietatea cerută, condiția e falsă și bean-ul nu se creează. Setează proprietatea sau oferă o implementare implicită.
3Ai folosit getBean în loc de injectare
Notificator n = context.getBean(Notificator.class);NotificareController(Notificator notificator) { this.notificator = notificator; }Injectarea prin constructor descoperă problema la pornire, nu la prima cerere.
Repară eroarea, direct în pagină
GET /notificari?mesaj=Salut răspunde cu 500 și mesajul No qualifying bean of type 'Notificator' available. Repară aplicația ca ruta să răspundă Email trimis: Salut. Păstrează căutarea bean-ului în controller.
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.ApplicationContext;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
interface Notificator {
String trimite(String mesaj);
}
class NotificatorEmail implements Notificator {
public String trimite(String mesaj) {
return "Email trimis: " + mesaj;
}
}
@RestController
class NotificareController {
private final ApplicationContext context;
NotificareController(ApplicationContext context) {
this.context = context;
}
@GetMapping("/notificari")
String trimite(@RequestParam String mesaj) {
return context.getBean(Notificator.class).trimite(mesaj);
}
}Tomcat started on port 8080 (http) Started Application GET /notificari?mesaj=Salut → 200 Email trimis: Salut
Indiciu
Containerul nu are nicio implementare a interfeței Notificator.
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.ApplicationContext;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
interface Notificator {
String trimite(String mesaj);
}
@Component
class NotificatorEmail implements Notificator {
public String trimite(String mesaj) {
return "Email trimis: " + mesaj;
}
}
@RestController
class NotificareController {
private final ApplicationContext context;
NotificareController(ApplicationContext context) {
this.context = context;
}
@GetMapping("/notificari")
String trimite(@RequestParam String mesaj) {
return context.getBean(Notificator.class).trimite(mesaj);
}
}De ce merge
getBean(Notificator.class) caută în container un bean care implementează Notificator. Clasa NotificatorEmail exista, dar nu era bean. Cu @Component, Spring o creează la pornire, iar căutarea o găsește. Observă că aplicația pornea fără eroare: problema apărea abia la cerere. Cu injectare prin constructor (NotificareController(Notificator n)), aceeași greșeală ar fi oprit pornirea, ceea ce e preferabil.
Alte forme ale mesajului
No qualifying bean of type 'Notificator' available: expected at least 1 bean which qualifies as autowire candidate.No bean named 'notificatorSms' available
Cum o eviți pe viitor
- Preferă injectarea prin constructor în locul lui
getBean: erorile apar la pornire, nu în producție. - Pentru bean-uri condiționate, documentează proprietatea și oferă un bean implicit cu
@ConditionalOnMissingBean. - Scrie un test care încarcă contextul și apelează rutele principale.
Întrebări frecvente
De ce aplicația pornește, dar pică la o cerere?
Pentru că bean-ul e cerut cu getBean în interiorul unei metode. Spring nu poate verifica la pornire ce vei cere mai târziu.
Ce diferență e față de NoUniqueBeanDefinitionException?
NoSuchBean... înseamnă zero candidați, NoUniqueBean... înseamnă mai mulți. Reparațiile sunt diferite: creezi bean-ul, respectiv alegi unul.
Erori înrudite
NoUniqueBeanDefinitionException: No qualifying bean of type 'Curier' available: expected single matching bean but found 2: curierRapid,curierEconomic Ai cerut un singur bean de un tip, dar containerul are două. Alege unul: marchează-l @Primary, cere-l după nume (getBean("curierRapid", Curier.class) sau @Qualifier) ori ia-le pe toate cu getBeansOfType / List. 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. 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. Î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.
