【Java】已解决：org.springframework.beans.factory.NoUniqueBeanDefinitionException非唯一Bean定义异常

屿小夏

发布于 2024-09-10 08:32:18

840

发布于 2024-09-10 08:32:18

文章被收录于专栏：IT杂谈学习

一、分析问题背景

在Spring框架的开发过程中，开发者可能会遇到org.springframework.beans.factory.NoUniqueBeanDefinitionException非唯一Bean定义异常。此异常通常发生在Spring容器中存在多个相同类型的Bean，而Spring无法确定要注入哪个Bean时。以下是一个典型的场景：

场景：在一个Spring Boot项目中，开发者定义了多个同类型的Bean，并在某个地方注入该类型的Bean。由于Spring无法确定具体要注入哪个Bean，导致抛出了NoUniqueBeanDefinitionException异常。

示例代码片段：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class AppConfig {

    @Bean
    public Service service1() {
        return new ServiceImpl1();
    }

    @Bean
    public Service service2() {
        return new ServiceImpl2();
    }
}

@Service
public class ConsumerService {

    private final Service service;

    @Autowired
    public ConsumerService(Service service) {
        this.service = service;
    }
}

当我们运行该代码时，会遇到org.springframework.beans.factory.NoUniqueBeanDefinitionException异常。

二、可能出错的原因

导致org.springframework.beans.factory.NoUniqueBeanDefinitionException报错的原因主要有以下几点：

同类型Bean的重复定义：在Spring容器中定义了多个相同类型的Bean，导致Spring无法确定要注入哪个Bean。
缺少特定Bean的限定符：没有使用@Qualifier注解来指定要注入的具体Bean。

三、错误代码示例

以下是一个可能导致该报错的代码示例，并解释其错误之处：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Configuration
public class AppConfig {

    @Bean
    public Service service1() {
        return new ServiceImpl1();
    }

    @Bean
    public Service service2() {
        return new ServiceImpl2();
    }
}

@Service
public class ConsumerService {

    private final Service service;

    @Autowired
    public ConsumerService(Service service) {
        this.service = service;
    }
}

错误分析：

同类型Bean的重复定义：在AppConfig类中定义了两个类型为Service的Bean，Spring无法确定要注入ConsumerService的具体是哪个Bean。

四、正确代码示例

为了解决该报错问题，我们可以使用@Qualifier注解来明确指定要注入的具体Bean。以下是正确的代码示例：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.stereotype.Service;

@Configuration
public class AppConfig {

    @Bean
    public Service service1() {
        return new ServiceImpl1();
    }

    @Bean
    public Service service2() {
        return new ServiceImpl2();
    }
}

@Service
public class ConsumerService {

    private final Service service;

    @Autowired
    public ConsumerService(@Qualifier("service1") Service service) {
        this.service = service;
    }
}

通过上述代码，我们使用@Qualifier注解明确指定要注入的是service1，从而避免了NoUniqueBeanDefinitionException异常。