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

NoSuchBeanDefinitionException: No qualifying bean of type 'Notificator' available

Pe scurt

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 by al unei injectări eșuate (Spring Boot o rezumă ca required 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

Greșit
JAVA
interface Notificator { String trimite(String m); }
class NotificatorEmail implements Notificator { ... }

context.getBean(Notificator.class);
Corect
JAVA
@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

Greșit
JAVA
@Component
@ConditionalOnProperty(name = "app.email.activ", havingValue = "true")
class NotificatorEmail implements Notificator { }
Corect
JAVA
app.email.activ=true

Fă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

Greșit
JAVA
Notificator n = context.getBean(Notificator.class);
Corect
JAVA
NotificareController(Notificator notificator) { this.notificator = notificator; }

Injectarea prin constructor descoperă problema la pornire, nu la prima cerere.

Repară tu

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.

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

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

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