一、同类型多bean问题：Spring也会"选择困难"
做Spring开发的朋友，大概率都遇到过这个坑------当我们定义了多个**同类型（同接口/同父类）**的Bean时，用@Autowired自动注入，直接就报错！报错信息大概是"No qualifying bean of type XXX available: expected single matching bean but found N"，翻译过来就是：Spring不知道该给你注入哪一个Bean～
先给大家看个最常见的报错示例：
java
// 1. 先整个通用接口
public interface UserService {
void queryUser();
}
// 2. 接口实现类1，正常加@Service注解
@Service
public class UserServiceImpl1 implements UserService {
@Override
public void queryUser() {
System.out.println("UserServiceImpl1 执行查询");
}
}
// 3. 接口实现类2，也加@Service注解
@Service
public class UserServiceImpl2 implements UserService {
@Override
public void queryUser() {
System.out.println("UserServiceImpl2 执行查询");
}
}
// 4. 重点来了：注入的时候直接报错
@Service
public class UserController {
// 报错！Spring：我咋知道你要哪个？
@Autowired
private UserService userService;
}下面介绍五种方法，随便选一种，都能帮Spring"做决定"，轻松解决注入冲突～
二、五种处理方式，简单好懂还好用
1. @Primary：指定"默认选手"
核心逻辑超简单：在多个同类型Bean里，给其中一个加个@Primary注解，相当于告诉Spring"实在选不出来，就选我！"，Spring会优先注入带这个注解的Bean。
适用场景：有一个Bean是你"最常用"的，大部分地方都要用到它，直接设为默认就完事。
示例代码：
java
// 实现类1：加@Primary，当选"默认选手"
@Service
@Primary // 关键一步，标记默认Bean
public class UserServiceImpl1 implements UserService {
@Override
public void queryUser() {
System.out.println("UserServiceImpl1 执行查询");
}
}
// 实现类2：不用改，当"备选选手"
@Service
public class UserServiceImpl2 implements UserService {
@Override
public void queryUser() {
System.out.println("UserServiceImpl2 执行查询");
}
}
// 注入类：啥也不用改，Spring自动找默认的
@Service
public class UserController {
@Autowired
private UserService userService; // 注入的就是UserServiceImpl1啦
}2. @Fallback：给Spring一个"备用方案"（Spring 6.0+ 新增）
核心逻辑：@Fallback注解就是给Bean加个"备用标签"，如果非@Fallback的Bean用不了、找不到，Spring就会自动找带这个注解的备用Bean，相当于给注入加了个"兜底保障"。
适用场景：有明确的首选Bean，但怕它出问题，需要一个备用Bean顶上去，降级逻辑轻松实现。
示例代码（记得要Spring 6.0及以上版本）：
java
// 实现类1：首选Bean，起个好记的名字
@Service("primaryUserService")
public class UserServiceImpl1 implements UserService {
@Override
public void queryUser() {
System.out.println("UserServiceImpl1 执行查询");
}
}
// 实现类2：备用Bean，加@Fallback标记
@Fallback
@Service("fallbackUserService")
public class UserServiceImpl2 implements UserService {
@Override
public void queryUser() {
System.out.println("UserServiceImpl2 执行查询");
}
}
// 注入类：正常注入，出问题自动切换备用
@Service
public class UserController {
// 首选primaryUserService，它不行就用fallbackUserService
@Autowired
private UserService primaryUserService;
}🔔 注意：兜底时，如果有多个@Fallback Bean，spring 仍然不知道要选哪个，需要进一步通过其他方式筛选处理
3. @Qualifier：精准"点名"要哪个Bean
核心逻辑：@Qualifier就像"点名器"，和@Autowired配合使用，直接告诉Spring"我要那个叫XXX的Bean"。Bean的名字默认是类名首字母小写，也能自己用@Service("名字")自定义。
适用场景：想精准控制注入哪个Bean，不用猜来猜去，这是最常用、最省心的方式～ 另外@Qualifier除了按名字注入，还有更高级的用法，感兴趣的小伙伴可以看这篇文章。
Spring Boot @Qualifier深度解密：从"按名查找"到"分组批量注入"，一文掌握它的全部"隐藏技能"。
示例代码：
java
// 方式1：用默认Bean名称（类名首字母小写）
@Service // 默认名字：userServiceImpl1
public class UserServiceImpl1 implements UserService {
@Override
public void queryUser() {
System.out.println("UserServiceImpl1 执行查询");
}
}
@Service // 默认名字：userServiceImpl2
public class UserServiceImpl2 implements UserService {
@Override
public void queryUser() {
System.out.println("UserServiceImpl2 执行查询");
}
}
// 注入类：用@Qualifier直接点名
@Service
public class UserController {
// 明确要注入name为userServiceImpl2的Bean
@Autowired
@Qualifier("userServiceImpl2")
private UserService userService;
}4. 泛型：用"类型标记"区分Bean
核心逻辑：利用泛型参数给Bean"贴标签"，Spring会根据泛型的具体类型，自动匹配对应的Bean。
适用场景：Bean的逻辑和泛型相关，比如"查普通用户"和"查管理员"，用泛型区分，语义更清晰，也不用记一堆Bean名称。
示例代码：
java
// 1. 先整个泛型接口，用泛型区分不同逻辑
public interface BaseService<T> {
void query(T t);
}
// 2. 实现类1：泛型设为User（普通用户）
@Service
public class UserService implements BaseService<User> {
@Override
public void query(User user) {
System.out.println("查询普通用户：" + user.getName());
}
}
// 3. 实现类2：泛型设为Admin（管理员）
@Service
public class AdminService implements BaseService<Admin> {
@Override
public void query(Admin admin) {
System.out.println("查询管理员：" + admin.getName());
}
}
// 4. 注入类：Spring自动根据泛型匹配，不用多操作
@Service
public class UserController {
// 注入泛型为User的Bean（就是UserService）
@Autowired
private BaseService<User> userService;
// 注入泛型为Admin的Bean（就是AdminService）
@Autowired
private BaseService<Admin> adminService;
}
// 补充：两个简单的实体类
class User {
private String name;
// getter/setter 省略，大家按需加就行
}
class Admin {
private String name;
// getter/setter 省略
}5. CustomAutowireConfigurer：自定义"注入规则"
核心逻辑：相当于给Spring定制一套"注入规矩"，配合自定义注解，能实现和@Qualifier类似的效果，但更灵活，适合特殊场景。
适用场景：想自定义一套匹配规则，比如按注解筛选Bean，适合有特殊需求的场景。
示例代码：
java
// 第一步：先自定义一个注解，用来筛选Bean
@Target({ ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER, ElementType.TYPE, ElementType.ANNOTATION_TYPE })
@Retention(RetentionPolicy.RUNTIME)
@Inherited
public @interface AutowireSel {
String value() default "";
}
// 第二步：定义同类型Bean，给需要优先注入的加自定义注解
@Service("userService_1")
@AutowireSel // 加注解，标记为符合规则的Bean
public class UserServiceImpl1 implements UserService {
@Override
public void queryUser() {
System.out.println("UserServiceImpl1 执行查询");
}
}
@Service("userService_2")
public class UserServiceImpl2 implements UserService {
@Override
public void queryUser() {
System.out.println("UserServiceImpl2 执行查询");
}
}
// 第三步：配置CustomAutowireConfigurer，告诉Spring我们的规则
@Configuration
public class AutowireConfig {
@Bean
public CustomAutowireConfigurer customAutowireConfigurer() {
CustomAutowireConfigurer configurer = new CustomAutowireConfigurer();
// 注册我们自定义的注解，作为筛选规则
configurer.setCustomQualifierTypes(Set.of(AutowireSel.class));
return configurer;
}
}
// 第四步：注入类，啥也不用多写，Spring自动匹配符合规则的Bean
@Service
public class UserController {
@Autowired
private UserService userService; // 注入的就是带@AutowireSel的userService_1
}三、总结：按需选，不踩坑
这五种方法没有好坏，关键看大家的实际需求，核心都是帮Spring"分清"该注入哪个Bean，给大家总结得明明白白，按需挑选就好：
- @Primary：最简单，适合有"默认首选Bean"的场景，不用多写一行多余代码。
- @Fallback：Spring 6.0+ 专属，适合需要"备用兜底"的场景，怕首选Bean出问题就用它。
- @Qualifier：最常用、最灵活，想精准注入某个Bean，用它准没错。
- 泛型：适合Bean逻辑和泛型相关的场景，代码简洁，还不用记Bean名称。
- CustomAutowireConfigurer：适合特殊需求，想自定义注入规则，就用它定制一套"规矩"。
实际开发中，@Qualifier和@Primary用得最多，基本能覆盖大部分场景；如果用的是Spring 6.0+，@Fallback可以当兜底补充；泛型和CustomAutowireConfigurer，遇到特殊场景再用就好