Spring IoC 容器与依赖注入核心机制详解

注意：当容器中存在多个同类型 Bean 时，若直接使用 context.getBean(User.class) 按类型获取，Spring 会抛出 NoUniqueBeanDefinitionException 异常，提示期望匹配一个但发现了多个（user1, user2）。

解决方案：通过 Bean 名称获取。

ApplicationContext context = SpringApplication.run(SpringIocDemoApplication.class, args);
User u1 = (User) context.getBean("user1");
User u2 = (User) context.getBean("user2");

1.3 Bean 重命名与语法简写

默认情况下，@Bean 生成的 Bean 名称为方法名。可通过 name 属性自定义名称，且支持配置多个别名：

@Bean(name = {"u1", "user1"})
public User user1() {
    User user = new User();
    user.setName("zhangsan");
    user.setAge(18);
    return user;
}

语法简写规则：

• 单个名称时可省略 name= 和大括号：@Bean("u1")
• 多个名称时可省略 name=：@Bean({"u1", "user1"})

注册后，可通过 context.getBean("u1") 或 context.getBean("user1") 获取对象。

二、Spring Bean 命名规则

💡 提示：该规则由 Spring 的 BeanNameGenerator 实现，旨在保证 Bean 名称的可读性与唯一性。如需自定义，可直接在注解中指定，如 @Service("myUserService") 或 @Bean("myOrderDao")。

三、组件扫描机制 (@ComponentScan)

3.1 扫描范围与生效条件

使用 @Component 等注解声明的类必须被 Spring 扫描到才会注册为 Bean。Spring Boot 的 @SpringBootApplication 已内置 @ComponentScan，默认扫描启动类所在包及其所有子包。

若 Bean 所在的包不在启动类的包或子包下，将导致 NoSuchBeanDefinitionException。此时需手动配置 @ComponentScan：

@ComponentScan({"com.example.service", "com.example.config"})
@SpringBootApplication
public class SpringIocDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringIocDemoApplication.class, args);
    }
}

3.2 @ComponentScan 核心用法

1. 指定扫描路径：@ComponentScan({"包路径1", "包路径2"})，需填写完整包名。
2. 包含/排除指定类：

   @ComponentScan(
       basePackages = "com.example",
       excludeFilters = @ComponentScan.Filter(
           type = FilterType.ASSIGNABLE_TYPE,
           classes = UserService.class
       )
   )
   

3. 与 @Configuration 的关联：配置类本身也必须被扫描到，否则其内部的 @Bean 方法不会执行。

3.3 避坑指南

• 避免重复扫描：手动配置时不要与默认范围重叠，否则可能导致 Bean 重复创建。
• 路径拼写准确：包路径错误会直接导致 Bean 无法注册。
• 最佳实践：尽量将业务类放在启动类所在包或子包下，依赖默认扫描，减少显式配置。

四、依赖注入 (DI) 的三种方式

依赖注入是 IoC 容器在创建 Bean 时，为其提供运行所依赖资源的过程。Spring 提供以下三种方式：

4.1 属性注入 (Field Injection)

直接在字段上使用 @Autowired 注解。

@Controller
public class UserController {
    @Autowired
    private UserService userService;
}

4.2 构造方法注入 (Constructor Injection)

在构造方法上添加 @Autowired（Spring 4.3+ 若仅有一个构造方法可省略该注解）。

@Controller
public class UserController {
    private final UserService userService;

    @Autowired
    public UserController(UserService userService) {
        this.userService = userService;
    }
}

4.3 Setter 注入

在 Setter 方法上添加 @Autowired。

@Controller
public class UserController {
    private UserService userService;

    @Autowired
    public void setUserService(UserService userService) {
        this.userService = userService;
    }
}

4.4 优缺点对比

📌 官方推荐：Spring 4.3 之后，官方推荐使用构造方法注入，以保证依赖的不可变性和提前校验。

五、多 Bean 注入冲突与解决方案

当使用 @Autowired 按类型注入，且容器中存在多个同类型 Bean 时，会抛出 NoUniqueBeanDefinitionException。Spring 提供以下解决方案：

5.1 使用 @Primary

标记首选 Bean，当存在多个同类型 Bean 时，优先注入被 @Primary 标注的实例。

@Primary
@Bean("u1")
public User user1() { /* ... */ }

5.2 使用 @Qualifier

配合 @Autowired 使用，通过 value 属性精确指定 Bean 名称。

@Autowired
@Qualifier("user2")
private User user;

5.3 使用 @Resource

JDK 提供的注解，默认按名称注入。通过 name 属性指定目标 Bean。

@Resource(name = "user2")
private User user;

六、@Autowired 与 @Resource 核心区别

使用建议

• 单实例场景：优先使用 @Autowired，代码更简洁，是 Spring 生态的标准实践。
• 多实例/精确匹配场景：使用 @Resource(name = "xxx") 可直接按名注入，避免类型歧义。
• 版本注意：在 JDK 9+ 及 Spring Boot 3.x 中，@Resource 所属包已迁移至 jakarta.annotation，需确保引入对应依赖。