Spring的 @Autowired 注解默认是优先按类型（ByType）进行查找的。当容器中存在多个相同类型的Bean时，它会退回到按属性名称（ByName）进行匹配。

这个设计是为了在保证类型安全的基础上，提供足够的灵活性来处理多个同类型Bean的场景。

详细工作机制

让我们分步解析这个过程：

1. 首要策略：按类型查找 (ByType)

这是 @Autowired 最核心、最优先的策略。

  • 如何工作： 当Spring容器看到一个带有 @Autowired 注解的字段、构造器或方法时，它会查看需要注入的对象的类型（例如 private UserService userService; 中的 UserService 接口或类），然后在它的应用上下文中寻找唯一一个类型匹配的Bean。
  • 例子：
    1
    2
    3
    4
    5
    6
    @Component
    public class OrderService {
        @Autowired
    ​    private UserService userService; // 查找类型为 UserService 的Bean
        // ...
    }
    只要Spring容器中有且仅有一个 UserService 类型的Bean（比如有一个 UserServiceImpl 类并标注了 @Component），注入就会成功。此时它完全不关心Bean的名字是什么。

2. 次级策略：按名称查找 (ByName) - 后备方案

当按类型查找失败时（即找到多个相同类型的Bean），Spring会启动后备方案：尝试使用属性/参数的名称作为Bean的ID去查找。

  • 何时触发： 当容器中存在多个 UserService 类型的Bean时。
  • 如何工作： Spring会查看你声明的变量名（例如 userService），然后去容器里找一个ID或名字正好是 userService 的Bean。
  • 例子：
    1
    2
    3
    4
    5
    6
    @Component
    public class OrderService {
        @Autowired
    ​    private UserService myUserService; // 变量名为 myUserService
        // ...
    }
    假设容器中有两个 UserService 的实现：
    1
    2
    3
    4
    5
    6
    7
    8
    @Component("defaultUserService") // Bean的名字是 defaultUserService
    public class DefaultUserService implements UserService { ... }

    @Component("specialUserService") // Bean的名字是 specialUserService
    public class SpecialUserService implements UserService { ... }

    @Component("myUserService")     // Bean的名字是 myUserService
    public class MyUserService implements UserService { ... }
    此时，按类型 (UserService) 查找会找到3个Bean，Spring无法做出选择，会抛出 NoUniqueBeanDefinitionException。但是，因为它启用了按名称查找的后备机制，它会尝试找一个名叫 myUserService 的Bean，正好与 MyUserService 类的Bean名字匹配，因此注入成功。

3. 使用 @Qualifier 进行精确控制

如果不想依赖变量名这个可能不稳定的因素（比如重构代码时改了变量名会导致注入失败），可以使用 @Qualifier 注解来显式指定要注入的Bean的名称。

  • 如何工作： @Qualifier 注解允许你直接告诉Spring要注入哪个具体名字的Bean，它完全绕过了按类型和按属性名查找的机制，直接按你指定的名字查找。
  • 例子：
    1
    2
    3
    4
    5
    6
    7
    @Component
    public class OrderService {
        @Autowired
        @Qualifier("specialUserService") // 明确指定要注入名为 ‘specialUserService’ 的Bean
        private UserService userService; // 变量名是什么已经不重要了
        // ...
    }
    这样，即使有多个 UserService，Spring也会精确地找到名字为 specialUserService 的那个Bean进行注入。

为什么这样设计？

这种“先类型，后名称”的设计哲学体现了Spring框架的几个核心原则：

  1. 鼓励面向接口编程和松耦合：

    • 默认按类型注入，意味着你的代码通常只依赖接口（如 UserService），而不是具体的实现类（如 UserServiceImpl）。这符合设计原则中的“依赖倒置原则”，使得代码更加灵活，更容易测试和维护。

  2. 提供灵活性而非限制：

    • 现实世界的应用是复杂的，不可避免地会出现一个接口有多个实现的场景（例如，连接不同数据库的DAO、针对不同客户的服务策略等）。如果 @Autowired 只支持按类型注入，那么这种常见需求就无法实现。按名称匹配作为后备机制，为解决“多态注入”问题提供了一个简单直观的解决方案。

  3. 平衡便利性和控制力：

    • 默认按类型：在大多数情况下（只有一个实现），开发者无需关心Bean的ID，非常方便。
    • 后备按名称：在出现多个实现时，提供了一个不引入新注解（如 @Qualifier）的快速解决方案，只需保持变量名和Bean名一致即可。
    • 使用 @Qualifier：当需要更明确、更稳定的控制时，提供了最强的控制力，将配置信息固化在注解中，而不受变量名更改的影响。

  4. 与Java标准注解 @Resource 的区别：

    • Java自带的 @Resource 注解（javax.annotation.Resource）的行为是先按名称再按类型（JSR-250标准）。Spring提供 @Autowired 这种不同的策略，给了开发者更多的选择。你可以根据场景选择更符合意图的注解：如果你更看重类型安全，用 @Autowired；如果你更看重通过名称来解析，用 @Resource。

总结

场景 查找策略 结果
找到1个该类型的Bean ByType 成功注入
找到0个该类型的Bean ByType 抛出 NoSuchBeanDefinitionException
找到多个该类型的Bean ByType -> ByName 尝试用属性名匹配Bean名，匹配则成功，否则失败
使用 @Qualifier ByQualifier 忽略类型和属性名，直接按指定名称查找

设计初衷：在保证主要场景（单一实现）极度简便的前提下，通过优雅的后备机制（按名称）和显式控制机制（@Qualifier）来处理复杂的多实现场景，从而在便利性、灵活性和明确性之间取得最佳平衡。