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

Parameter 0 of constructor in ComandaController required a single bean, but 2 were found

Pe scurt

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

Greșit
JAVA
@Service class PlataCard implements Plata { }
@Service class PlataTransfer implements Plata { }

ComandaController(Plata plata) { }
Corect
JAVA
@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

Greșit
JAVA
FacturaController(Plata plata) { }
Corect
JAVA
FacturaController(@Qualifier("plataTransfer") Plata plata) { }

@Qualifier alege bean-ul după nume, indiferent câți candidați există.

3Același tip declarat de două ori

Greșit
JAVA
@Bean ObjectMapper mapper1() { ... }
@Bean ObjectMapper mapper2() { ... }
Corect
JAVA
@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ă tu

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.

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

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 @Qualifier doar în locurile care chiar au nevoie de varianta specială.
  • Când alegerea depinde de date (tipul plății din cerere), injectează List<Plata> sau Map<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

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