在JavaConfig中使用@Qualifier+@Bean(autowire=Autowire.BY_TYPE)遇NoQualifyingBeanException

我来帮你分析下这个问题——你遇到的NoQualifyingBeanException本质是Spring在按类型自动装配时，发现有多个同类型的Address Bean，不知道该选哪一个。而你当前把@Qualifier注解加在了Employee的@Bean方法上，这是错误的用法，这就是问题的核心原因。

错误原因说明 #

@Qualifier注解的作用是在依赖注入时指定要选择的Bean实例，它应该标注在依赖注入的目标位置（比如Employee类中的Address字段、构造方法参数、setter方法参数），而不是标注在定义Employee Bean的@Bean方法上。你现在的写法相当于给Employee Bean本身打了个Qualifier标签，完全没告诉Spring要选哪个Address。

几种可行的解决方案 #

方案1：在Employee类的依赖注入点添加@Qualifier

修改你的Employee类，在注入Address的位置（构造方法、setter或字段）加上@Qualifier，明确指定要使用的Address Bean名称：

public class Employee {
    private Address address;

    // 构造方法注入示例
    @Autowired
    public Employee(@Qualifier("addr1") Address address) {
        this.address = address;
    }

    // 或者setter方法注入示例
    @Autowired
    @Qualifier("addr1")
    public void setAddress(Address address) {
        this.address = address;
    }
}

然后你的配置类可以简化，不需要在Employee的@Bean方法上加autowire和@Qualifier：

@Configuration
public class MyConfig {
    @Bean(name="addr1")
    public Address address() {
        return new Address("Hello","hi",112233);
    }
    @Bean(name="address")
    public Address addressAgain() {
        return new Address("See You","Bi",114422);
    }
    @Bean(name="emp")
    public Employee employee() {
        return new Employee(); // 依赖会通过@Autowired+@Qualifier自动注入
    }
}

方案2：在配置类的Employee Bean方法中直接指定依赖

在配置类里定义Employee Bean时，通过方法参数注入Address，并给参数加上@Qualifier，这种方式不需要修改Employee类：

@Configuration
public class MyConfig {
    @Bean(name="addr1")
    public Address address() {
        return new Address("Hello","hi",112233);
    }
    @Bean(name="address")
    public Address addressAgain() {
        return new Address("See You","Bi",114422);
    }
    @Bean(name="emp")
    public Employee employee(@Qualifier("addr1") Address address) {
        Employee emp = new Employee();
        emp.setAddress(address);
        return emp;
    }
}

这种方式更适合控制反转的配置型写法，完全在配置类中管理依赖关系，不需要在业务类中加Spring注解。

方案3：将其中一个Address Bean设为@Primary

如果你的场景中，某个Address Bean是默认优先被选择的，可以给它加上@Primary注解，这样Spring按类型装配时会自动选择这个Bean：

@Configuration
public class MyConfig {
    @Bean(name="addr1")
    @Primary // 标记为优先选择的Bean
    public Address address() {
        return new Address("Hello","hi",112233);
    }
    @Bean(name="address")
    public Address addressAgain() {
        return new Address("See You","Bi",114422);
    }
    @Bean(name="emp", autowire=Autowire.BY_TYPE)
    public Employee employee() {
        return new Employee();
    }
}

这种方式适合有一个默认实现的场景，不需要额外指定Qualifier。

总结 #

你之前的核心错误是@Qualifier的使用位置不对，只要把它放在依赖注入的目标点（字段、构造参数、方法参数），或者用@Primary指定默认Bean，就能解决这个多Bean冲突的问题。

内容的提问来源于stack exchange，提问作者user1257846