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

NoUniqueBeanDefinitionException: No qualifying bean of type 'Curier' available: expected single matching bean but found 2: curierRapid,curierEconomic

Pe scurt

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

Greșit
JAVA
Curier c = context.getBean(Curier.class);
Corect
JAVA
Curier c = context.getBean("curierRapid", Curier.class);

Cu numele bean-ului, căutarea are un singur rezultat.

2Nicio implementare implicită

Greșit
JAVA
@Component class CurierRapid implements Curier { }
@Component class CurierEconomic implements Curier { }
Corect
JAVA
@Component @Primary class CurierEconomic implements Curier { }
@Component class CurierRapid implements Curier { }

@Primary spune ce bean primești când ceri doar tipul.

Repară tu

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.

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

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

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