Что делать, если Spring обнаружил несколько кандидатов для внедрения зависимости?

Проблема множественных кандидатов

Когда Spring контейнер обнаруживает несколько бинов одного типа, предназначенных для внедрения в одно и то же поле или конструктор, возникает конфликт. Контейнер не может определить, какой именно бин использовать, и выбрасывает исключение NoUniqueBeanDefinitionException. Это типичная ситуация при работе с интерфейсами, имеющими несколько реализаций.

Способы разрешения конфликта

• @Primary — указывает, что данный бин является основным. Если есть несколько кандидатов, Spring выберет бин с этой аннотацией.
• @Qualifier — позволяет задать конкретное имя или квалификатор для бина. При внедрении указывается тот же квалификатор.
• @Resource — аннотация из Java EE, которая по умолчанию ищет бин по имени, а затем по типу.
• Внедрение коллекции — можно внедрить все бины в List или Map и выбрать нужный программно.

Пример кода

public interface PaymentService {
    void pay(double amount);
}

@Component
@Primary
public class CreditCardPayment implements PaymentService {
    public void pay(double amount) {
        System.out.println("Оплата картой: " + amount);
    }
}

@Component
@Qualifier("paypal")
public class PayPalPayment implements PaymentService {
    public void pay(double amount) {
        System.out.println("Оплата PayPal: " + amount);
    }
}

@Component
public class OrderService {
    @Autowired
    @Qualifier("paypal")
    private PaymentService paymentService;
    // или @Resource(name = "paypalPayment")
}

Вывод

Используйте @Primary для задания бина по умолчанию, а @Qualifier для точного выбора конкретной реализации. Это делает код гибким и позволяет легко переключаться между разными реализациями без изменения логики.