Что произойдет, если Spring найдет несколько Bean

Несколько Bean в Spring: проблема и решения

Если Spring Framework при автоматическом внедрении зависимостей (autowiring) обнаружит несколько Bean одного типа, это приведёт к NoUniqueBeanDefinitionException. Это серьёзная проблема, так как контейнер не может автоматически определить, какой именно Bean нужно внедрить.

Ошибка при конфликте

Если в контексте определены несколько Bean одного типа:

@Configuration
public class AppConfig {
    @Bean
    public PaymentService paypalService() {
        return new PaypalPaymentService();
    }

    @Bean
    public PaymentService stripeService() {
        return new StripePaymentService();
    }
}

@Service
public class OrderService {
    @Autowired
    private PaymentService paymentService; // ОШИБКА!
}

При запуске приложения получим ошибку: NoUniqueBeanDefinitionException.

Решение 1: @Qualifier

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

@Service
public class OrderService {
    @Autowired
    @Qualifier("paypalService")
    private PaymentService paymentService; // Внедрится paypalService
}

Или в конструкторе:

@Service
public class OrderService {
    private PaymentService paymentService;

    @Autowired
    public OrderService(@Qualifier("stripeService") PaymentService service) {
        this.paymentService = service;
    }
}

Решение 2: @Primary

Указывает Bean, который должен быть выбран по умолчанию при конфликте:

@Configuration
public class AppConfig {
    @Bean
    @Primary
    public PaymentService paypalService() {
        return new PaypalPaymentService();
    }

    @Bean
    public PaymentService stripeService() {
        return new StripePaymentService();
    }
}

@Service
public class OrderService {
    @Autowired
    private PaymentService paymentService; // Внедрится paypalService
}

Решение 3: ObjectProvider

Используется для более гибкой работы с несколькими Bean одного типа:

@Service
public class OrderService {
    private List<PaymentService> paymentServices;

    @Autowired
    public OrderService(ObjectProvider<PaymentService> provider) {
        this.paymentServices = provider.stream().collect(Collectors.toList());
    }

    public void process() {
        paymentServices.forEach(service -> service.process());
    }
}

Решение 4: Внедрение списка всех Bean

Если нужно работать со всеми Bean одного типа:

@Service
public class PaymentProcessor {
    private final List<PaymentService> services;

    @Autowired
    public PaymentProcessor(List<PaymentService> services) {
        this.services = services; // Внедрит все PaymentService Bean
    }

    public void processAll() {
        services.forEach(PaymentService::process);
    }
}

Решение 5: Условное создание Bean

Используем @ConditionalOnProperty:

@Configuration
public class AppConfig {
    @Bean
    @ConditionalOnProperty(name = "payment.provider", havingValue = "paypal")
    public PaymentService paymentService() {
        return new PaypalPaymentService();
    }
}

Практические рекомендации

1. Используй @Qualifier — явное лучше неявного
2. @Primary — только для одного действительно основного Bean
3. Разделяй интерфейсы — если возможно, создай отдельные интерфейсы для разных реализаций
4. Документируй выбор — комментариями объясни, почему выбран именно этот Bean

Правильное управление несколькими Bean — это важная часть написания чистого и поддерживаемого Spring приложения.