如何解决Spring中的org.springframework.beans.factory.NoUniqueBeanDefinitionException异常

先明确你的代码结构：

class A {
   public void first(){
   }
}

class B extends A {
   public void first(){
   }
}

当Spring容器中存在多个A类型的Bean（A本身和子类B）时，直接按类型注入会抛出NoUniqueBeanDefinitionException，以下是几个有效的解决办法：

方案1：正确使用@Qualifier配合@Autowired #

你之前用@Qualifier无效大概率是使用方式不对。需要给每个Bean指定唯一限定符，注入时匹配对应名称：

步骤1：给Bean添加标识 #

可以用@Qualifier指定，也直接用@Component的value属性定义Bean名称，效果一致：

import org.springframework.stereotype.Component;
import org.springframework.beans.factory.annotation.Qualifier;

@Component
@Qualifier("beanA")
class A {
   public void first(){
       // 实现逻辑
   }
}

@Component
@Qualifier("beanB")
class B extends A {
   public void first(){
       // 实现逻辑
   }
}

步骤2：注入时指定目标Bean #

注入时通过@Qualifier明确要使用的Bean，再根据条件调用：

@Autowired
@Qualifier("beanA")
private A beanA;

@Autowired
@Qualifier("beanB")
private A beanB;

// 条件调用示例
if (someCondition) {
    beanA.first();
} else {
    beanB.first();
}

方案2：注入所有A类型Bean集合，动态选择 #

直接注入List<A>或Map<String, A>，Spring会自动收集所有A类型的Bean，再根据条件筛选：

注入List集合 #

@Autowired
private List<A> aBeans;

public void callFirstMethod(boolean useB) {
    for (A bean : aBeans) {
        if (useB && bean instanceof B) {
            bean.first();
            break;
        } else if (!useB && bean instanceof A && !(bean instanceof B)) {
            bean.first();
            break;
        }
    }
}

注入Map集合（键为Bean名称，值为实例） #

这种方式更直观，直接通过Bean名称获取目标实例：

@Autowired
private Map<String, A> aBeanMap;

public void callFirstMethod(String beanName) {
    A targetBean = aBeanMap.get(beanName);
    if (targetBean != null) {
        targetBean.first();
    }
}

// 调用示例
callFirstMethod("beanA");
callFirstMethod("beanB");

方案3：用@Primary指定默认Bean #

如果大部分场景默认使用某个Bean，少数情况用另一个，可以给默认Bean加@Primary注解，Spring会优先注入该Bean：

@Component
@Primary
class A { ... }

@Component
class B extends A { ... }

此时直接注入A会自动获取A的实例，需要B时再配合@Qualifier：

@Autowired
private A defaultBean; // 注入的是A的实例

@Autowired
@Qualifier("b") // B的默认Bean名称是类名首字母小写"b"
private A beanB;

方案4：通过ApplicationContext动态获取Bean #

如果需要更灵活的动态获取，或者在非Spring管理类中使用，可以注入ApplicationContext来获取Bean：

@Autowired
private ApplicationContext context;

public void callFirstMethod(boolean useB) {
    A targetBean;
    if (useB) {
        targetBean = context.getBean("beanB", A.class);
    } else {
        targetBean = context.getBean("beanA", A.class);
    }
    targetBean.first();
}

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