Spring中@Qualifier在Setter注入时的异常行为：类级@Qualifier为何会忽略方法级@Qualifier？

这是个非常典型的Spring限定符匹配场景，我来帮你理清背后的运行机制，解释为什么修改Foo类后代码能正常运行：

先回顾你的场景 #

1. 初始状态：你定义了两个Foo类型的Bean（foo1、foo2），在Bar的setFoo方法上用@Autowired + @Qualifier("foo3")，因为不存在id为foo3的Bean，直接报错——这完全符合预期，因为Spring找不到匹配限定符的Bean。
2. 修改后状态：给Foo类加上@Qualifier("foo3")，此时setFoo方法上的@Qualifier("foo3")好像被"忽略"了，Spring成功注入了foo1和foo2，但你明明没有定义foo3这个Bean。

核心原因：类级别@Qualifier的作用范围 #

当你在类上添加@Qualifier注解时，这个限定符会成为该类型所有Bean的默认标签。也就是说，你用@Bean定义的foo1和foo2，现在都会自动携带foo3这个限定符属性——相当于每个@Bean方法上都隐式加了@Qualifier("foo3")。

方法上@Qualifier的实际作用 #

你在setFoo方法上写的@Qualifier("foo3")，并不是作用于整个方法，而是会应用到方法的每一个参数上。换句话说，这个写法等价于：

@Autowired
void setFoo(@Qualifier("foo3") Foo foo1, @Qualifier("foo3") Foo foo2) {
    // ...
}

为什么能成功注入？参数名称匹配救了场 #

现在，两个Foo Bean都带有foo3的限定符，完全满足参数的要求。但这里有两个符合条件的Bean，为什么没有抛出"找不到唯一Bean"的异常？

答案是Spring的参数名称匹配机制：当多个Bean符合限定符条件时，Spring会尝试用方法参数的名称去匹配Bean的名称。你的参数名正好是foo1和foo2，和两个Bean的id完全一致，所以Spring精准地把foo1注入第一个参数，foo2注入第二个参数，完美完成注入流程。

验证这个逻辑的小实验 #

如果把方法参数名改成不匹配的名字，比如：

@Autowired
@Qualifier("foo3")
void setFoo(Foo a, Foo b) {
    // ...
}

这时候Spring会发现有两个符合foo3限定符的Bean，但参数名a、b和任何Bean名都不匹配，就会抛出NoUniqueBeanDefinitionException，提示无法确定要注入哪个Bean。

总结一下 #

• 类级别的@Qualifier会给该类型所有实例Bean添加这个限定符标签；
• 方法上的@Qualifier会作用于方法的每一个参数；
• 当多个Bean满足限定符条件时，Spring会 fallback 到参数名称匹配Bean名称的逻辑完成注入。

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