Какой бин будет использован при наличии двух бинов одного типа с разной реализацией в Spring?

# Выбор бина при наличии нескольких реализаций в Spring

Когда в контексте Spring зарегистрировано несколько бинов одного типа (interface с несколькими реализациями), возникает неоднозначность. Spring использует несколько механизмов разрешения этой проблемы.

Основные механизмы

1. @Primary аннотация

Это наиболее предпочтительный способ. Когда несколько бинов подходят, Spring выбирает тот, который помечен @Primary:

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

@Component
public class CreditCardPayment implements PaymentService {
    @Override
    public void pay(double amount) {
        System.out.println("Платёж кредитной картой: " + amount);
    }
}

@Component
@Primary  // Этот бин будет использован по умолчанию
public class PayPalPayment implements PaymentService {
    @Override
    public void pay(double amount) {
        System.out.println("Платёж через PayPal: " + amount);
    }
}

@Service
public class OrderService {
    private final PaymentService paymentService; // Будет внедрена PayPalPayment
    
    public OrderService(PaymentService paymentService) {
        this.paymentService = paymentService;
    }
}

2. @Qualifier аннотация

Этот способ позволяет явно указать, какой бин внедрить по имени:

@Component
public class CreditCardPayment implements PaymentService {
    // ...
}

@Component
public class PayPalPayment implements PaymentService {
    // ...
}

@Service
public class OrderService {
    private final PaymentService paymentService;
    
    // Явно указываем использовать бин с именем "creditCardPayment"
    public OrderService(@Qualifier("creditCardPayment") PaymentService paymentService) {
        this.paymentService = paymentService;
    }
}

3. Имя параметра конструктора

Eсли параметр конструктора совпадает с именем бина, Spring выберет его:

@Service
public class OrderService {
    private final PaymentService paymentService;
    
    // Параметр "payPalPayment" совпадает с именем бина
    public OrderService(PaymentService payPalPayment) {
        this.paymentService = payPalPayment;
    }
}

4. Имя переменной поля при @Autowired

Когда используется field injection, Spring смотрит на имя поля:

@Service
public class OrderService {
    @Autowired
    private PaymentService creditCardPayment;  // Выберет бин с этим именем
}

Приоритет разрешения

1. @Qualifier — наивысший приоритет
2. @Primary — второй приоритет
3. Имя параметра/поля — если совпадает с именем бина
4. Ошибка NoUniqueBeanDefinitionException — если ничего не подходит

Конкретный пример ошибки и решения

// ❌ Ошибка: expected single matching bean but found 2
@Service
public class OrderService {
    private final PaymentService paymentService;
    
    public OrderService(PaymentService paymentService) {
        // Spring не знает, какой из двух бинов выбрать
        this.paymentService = paymentService;
    }
}

// ✅ Решение 1: @Primary
@Component
@Primary
public class PayPalPayment implements PaymentService { }

// ✅ Решение 2: @Qualifier
public OrderService(@Qualifier("payPalPayment") PaymentService paymentService) { }

// ✅ Решение 3: совпадение имён
public OrderService(PaymentService payPalPayment) { }

Лучшие практики

• Используй @Primary для "по умолчанию" реализации
• Используй @Qualifier для явного выбора в сложных сценариях
• Избегай полагаться на имена переменных (это неявно)
• @Primary + @Qualifier — @Qualifier переопределит @Primary

Итог

При наличии нескольких бинов одного типа Spring выбирает их в таком порядке:

1. Бин с @Qualifier (если указан)
2. Бин с @Primary (если обозначен)
3. Бин с именем, совпадающим с параметром конструктора/поля
4. Ошибка, если ничего не подходит