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").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul complet listează candidații:
Parameter 0 of constructor in ComandaController required a single bean, but 2 were found:
- plataCard: defined in file [PlataCard.class]
- plataTransfer: defined in file [PlataTransfer.class]Injectarea după tip funcționează doar când tipul cerut are un singur bean. Dacă două clase implementează aceeași interfață și ambele sunt @Service, Spring nu ghicește pe care o vrei și oprește pornirea. Numele din listă sunt numele bean-urilor: numele clasei cu prima literă mică (plataCard) sau numele metodei @Bean.
Ai trei variante: marchezi una ca implicită cu @Primary, alegi explicit cu @Qualifier("plataTransfer") în locul unde injectezi, sau ceri toate implementările (List<Plata>) când chiar ai nevoie de toate.
De ce apare: cauzele frecvente
1Două implementări ale aceleiași interfețe
@Service class PlataCard implements Plata { }
@Service class PlataTransfer implements Plata { }
ComandaController(Plata plata) { }@Service @Primary class PlataCard implements Plata { }
@Service class PlataTransfer implements Plata { }
ComandaController(Plata plata) { }@Primary desemnează implementarea folosită când nu ceri altceva explicit.
2Ai nevoie de o implementare anume
FacturaController(Plata plata) { }FacturaController(@Qualifier("plataTransfer") Plata plata) { }@Qualifier alege bean-ul după nume, indiferent câți candidați există.
3Același tip declarat de două ori
@Bean ObjectMapper mapper1() { ... }
@Bean ObjectMapper mapper2() { ... }@Bean @Primary ObjectMapper mapper() { ... }
@Bean ObjectMapper mapperXml() { ... }Două metode @Bean cu același tip de retur produc tot doi candidați. Unul trebuie să fie principal.
Repară eroarea, direct în pagină
Magazinul are două plăți, PlataCard și PlataTransfer, iar aplicația nu pornește: required a single bean, but 2 were found. Fă plata cu cardul implicită pentru ComandaController, iar FacturaController trebuie să plătească mereu prin transfer.
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.Primary;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
interface Plata {
String plateste(int suma);
}
@Service
class PlataCard implements Plata {
public String plateste(int suma) {
return "Card: " + suma + " lei";
}
}
@Service
class PlataTransfer implements Plata {
public String plateste(int suma) {
return "Transfer: " + suma + " lei";
}
}
@RestController
class ComandaController {
private final Plata plata;
ComandaController(Plata plata) {
this.plata = plata;
}
@PostMapping("/comenzi")
String comanda(@RequestParam int suma) {
return plata.plateste(suma);
}
}
@RestController
class FacturaController {
private final Plata plata;
FacturaController(Plata plata) {
this.plata = plata;
}
@PostMapping("/facturi")
String factura(@RequestParam int suma) {
return plata.plateste(suma);
}
}Tomcat started on port 8080 (http) Started Application POST /comenzi?suma=120 → 200 Card: 120 lei POST /facturi?suma=3000 → 200 Transfer: 3000 lei
Indiciu
O adnotare pe PlataCard o face implicită; în FacturaController ceri bean-ul plataTransfer după nume.
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.annotation.Primary;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
interface Plata {
String plateste(int suma);
}
@Service
@Primary
class PlataCard implements Plata {
public String plateste(int suma) {
return "Card: " + suma + " lei";
}
}
@Service
class PlataTransfer implements Plata {
public String plateste(int suma) {
return "Transfer: " + suma + " lei";
}
}
@RestController
class ComandaController {
private final Plata plata;
ComandaController(Plata plata) {
this.plata = plata;
}
@PostMapping("/comenzi")
String comanda(@RequestParam int suma) {
return plata.plateste(suma);
}
}
@RestController
class FacturaController {
private final Plata plata;
FacturaController(@Qualifier("plataTransfer") Plata plata) {
this.plata = plata;
}
@PostMapping("/facturi")
String factura(@RequestParam int suma) {
return plata.plateste(suma);
}
}De ce merge
Cu @Primary pe PlataCard, orice injectare a tipului Plata fără alte indicații primește cardul, deci ComandaController pornește fără modificări. FacturaController folosește @Qualifier("plataTransfer"), care alege bean-ul după nume și are prioritate față de @Primary. Numele bean-ului este numele clasei cu prima literă mică. Nu șterge una dintre implementări doar ca să scapi de eroare: ambele sunt utile.
Alte forme ale mesajului
Field plata in ComandaService required a single bean, but 2 were found:No qualifying bean of type 'Plata' available: expected single matching bean but found 2: plataCard,plataTransfer
Cum o eviți pe viitor
- Când adaugi a doua implementare a unei interfețe, decide imediat care este cea implicită (
@Primary). - Folosește
@Qualifierdoar în locurile care chiar au nevoie de varianta specială. - Când alegerea depinde de date (tipul plății din cerere), injectează
List<Plata>sauMap<String, Plata>și alege la rulare.
Întrebări frecvente
Ce câștigă dacă am și @Primary și @Qualifier?
@Qualifier câștigă: este o cerere explicită pentru un anumit bean, în timp ce @Primary e doar alegerea implicită.
Pot numi parametrul ca bean-ul în loc de @Qualifier?
Da, ca ultimă variantă Spring compară numele parametrului cu numele bean-urilor. Funcționează doar dacă proiectul e compilat cu -parameters și e fragil la redenumiri, așa că @Qualifier e mai clar.
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. Parameter 0 of constructor in ComandaService required a bean of type 'StocService' that could not be found. Constructorul unui bean cere un parametru (aici primul, indexul 0) pentru care Spring nu are niciun bean de tipul respectiv. Fă clasa dependenței bean (@Service, @Component sau o metodă @Bean) sau corectează tipul parametrului. 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.
