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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
NoUniqueBeanDefinitionException apare când codul cere un bean doar după tip, iar tipul are mai mulți candidați. Partea de după found 2: listează numele bean-urilor (curierRapid, curierEconomic), adică exact valorile pe care le poți folosi la alegere.
La pornire, Spring Boot afișează aceeași problemă în forma prietenoasă required a single bean, but 2 were found. Forma lungă o vezi în loguri, în teste și când apelezi context.getBean(Curier.class) în cod: atunci aplicația pornește, iar eroarea apare la prima cerere care ajunge la acel cod.
Nu e o eroare de configurare greșită în sine: e normal să ai mai multe implementări. Trebuie doar să spui care se folosește implicit sau să o alegi explicit.
De ce apare: cauzele frecvente
1getBean doar după tip
Curier c = context.getBean(Curier.class);Curier c = context.getBean("curierRapid", Curier.class);Cu numele bean-ului, căutarea are un singur rezultat.
2Nicio implementare implicită
@Component class CurierRapid implements Curier { }
@Component class CurierEconomic implements Curier { }@Component @Primary class CurierEconomic implements Curier { }
@Component class CurierRapid implements Curier { }@Primary spune ce bean primești când ceri doar tipul.
Repară eroarea, direct în pagină
GET /livrare?tip=curierRapid răspunde cu 500: expected single matching bean but found 2. Modifică controller-ul ca să primească toți curierii într-un Map<String, Curier> (cheia este numele bean-ului) și să aleagă după parametrul tip, astfel încât curierRapid și curierEconomic să răspundă fiecare cu textul lui.
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 Curier {
String livreaza();
}
@Component
class CurierRapid implements Curier {
public String livreaza() {
return "Livrare a doua zi";
}
}
@Component
class CurierEconomic implements Curier {
public String livreaza() {
return "Livrare în 3-5 zile";
}
}
@RestController
class LivrareController {
private final ApplicationContext context;
LivrareController(ApplicationContext context) {
this.context = context;
}
@GetMapping("/livrare")
String livrare(@RequestParam String tip) {
// TODO: alege curierul după tip
return context.getBean(Curier.class).livreaza();
}
}Tomcat started on port 8080 (http) Started Application GET /livrare?tip=curierRapid → 200 Livrare a doua zi GET /livrare?tip=curierEconomic → 200 Livrare în 3-5 zile
Indiciu
Cere în constructor Map<String, Curier> în locul lui ApplicationContext.
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.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
interface Curier {
String livreaza();
}
@Component
class CurierRapid implements Curier {
public String livreaza() {
return "Livrare a doua zi";
}
}
@Component
class CurierEconomic implements Curier {
public String livreaza() {
return "Livrare în 3-5 zile";
}
}
@RestController
class LivrareController {
private final Map<String, Curier> curieri;
LivrareController(Map<String, Curier> curieri) {
this.curieri = curieri;
}
@GetMapping("/livrare")
String livrare(@RequestParam String tip) {
return curieri.get(tip).livreaza();
}
}De ce merge
getBean(Curier.class) cere „singurul” curier, dar există doi, deci Spring aruncă NoUniqueBeanDefinitionException. Când ceri un Map<String, Curier>, Spring pune în el toate implementările, cu numele bean-ului drept cheie: curierRapid și curierEconomic (numele claselor cu prima literă mică). Alegerea se face la rulare, după valoarea din cerere, iar dependența se vede în constructor, nu ascunsă într-un apel getBean.
Alte forme ale mesajului
No qualifying bean of type 'Curier' available: expected single matching bean but found 3: curierRapid,curierEconomic,curierPosta
Cum o eviți pe viitor
- Când ai mai multe implementări, stabilește una implicită cu
@Primary. - Când alegerea depinde de date, injectează
Map<String, Curier>(cheia e numele bean-ului) și alege din hartă. - Evită
getBeanîn codul aplicației; injectarea face problemele vizibile la pornire.
Întrebări frecvente
Cum aleg implementarea în funcție de o valoare din cerere?
Injectează Map<String, Curier>: Spring pune toate implementările, cu numele bean-ului drept cheie. Apoi curieri.get(tip) alege la rulare.
Unde văd numele bean-urilor?
Chiar în mesaj, după found 2:. Implicit este numele clasei cu prima literă mică, sau numele metodei @Bean.
Erori înrudite
Parameter 0 of constructor in ComandaController required a single bean, but 2 were found Spring trebuie să injecteze un singur obiect de un tip (de obicei o interfață), dar a găsit două bean-uri care se potrivesc. Marchează implementarea implicită cu @Primary sau cere-o explicit cu @Qualifier("numeBean"). 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ă. 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.
