Spring IoC 与依赖注入（DI）核心机制详解

如果直接通过类型获取对象，Spring 会报错，提示期望只有一个匹配，结果发现了两个。这是因为容器中存在多个同类型的 Bean。

此时可以通过 Bean 名称来获取：

ApplicationContext context = SpringApplication.run(SpringIocDemoApplication.class, args);
User user1 = (User) context.getBean("user1");
User user2 = (User) context.getBean("user2");
System.out.println(user1);
System.out.println(user2);

运行结果会分别输出张三和李四的信息。这说明 @Bean 可以针对同一个类定义多个对象，默认 Bean 名称即为方法名。

Bean 重命名

我们可以通过设置 name 属性给 Bean 对象进行重命名操作：

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

此时既可以使用 u1 也可以使用 user1 获取对象。语法上支持简写：单个名称时大括号可省略，name= 也可省略。

Bean 命名规则总结

Spring 根据类名自动生成 Bean Name，规则如下：

• 情况 1：类名前两个字母都是大写 → Bean Name 等于类名本身。例：HTTPClient → HTTPClient。
• 情况 2：其他情况 → Bean Name 是类名的首字母小写驼峰写法。例：UserService → userService。

对于 @Bean 注解，Bean Name 直接等于方法名。如果想自定义 Bean Name，可以直接在注解里指定，如 @Service("myUserService") 或 @Bean(name = "myOrderDao")。

扫描路径与生效条件

使用 @Component/@Service 等注解声明的 Bean，并不一定会自动生效。Bean 想要生效，必须被 Spring 扫描到。未被扫描的注解不会被注册为 Bean。

Spring Boot 的 @SpringBootApplication 已经包含了 @ComponentScan，默认扫描范围是启动类所在的包及其所有子包。因此，大部分场景下无需手动配置。

但在以下情况需要手动配置 @ComponentScan：

1. Bean 所在的包不在启动类的包或子包下。
2. 想精确控制扫描范围（如只扫描 service 和 controller 包）。
3. 想排除某些不想被扫描的类。

基础用法是指定扫描的包路径：

@ComponentScan({"com.example.service", "com.example.controller"})
@SpringBootApplication
public class SpringIocDemoApplication {
    // ...
}

进阶用法可以包含或排除指定类，适合临时排除某个类，或者只扫描特定类型的注解。

需要注意的是，@Configuration 标记的配置类也需要被 @ComponentScan 扫描到，否则里面的 @Bean 方法不会被执行。推荐做法是把启动类放在我们希望扫描的包的路径下，这样定义的 Bean 就都可以被扫描到。

依赖注入（DI）详解

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

1. 属性注入（Field Injection）

通过 @Autowired 注解实现，将 Service 类注入到 Controller 类中：

@Service
public class UserService {
    public void sayHi() {
        System.out.println("Hi, UserService");
    }
}

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

    public void sayHi() {
        System.out.println("hi, UserController...");
        userService.sayHi();
    }
}

2. 构造方法注入（Constructor Injection）

在类的构造方法中实现注入，这是 Spring 4.X 后官方推荐的方式：

@Controller
public class UserController2 {
    private final UserService userService;

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

    public void sayHi() {
        System.out.println("hi, UserController2...");
        userService.sayHi();
    }
}

注意事项：如果类只有一个构造方法，@Autowired 注解可以省略；如果有多个构造方法，需要明确指定。

3. Setter 注入（Setter Injection）

通过类的 Setter 方法实现，需在 set 方法上添加 @Autowired 注解：

@Controller
public class UserController3 {
    private UserService userService;

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

    public void sayHi() {
        System.out.println("hi, UserController3...");
        userService.sayHi();
    }
}

三种注入方式对比

• 属性注入：简洁方便，但只能用于 IoC 容器，无法注入 Final 修饰的属性，且存在空指针风险。
• 构造方法注入：推荐方式。可以注入 Final 属性，依赖对象在使用前已完全初始化，通用性好，更换框架也适用。缺点是注入多个对象时代码稍繁琐。
• Setter 注入：方便实例化后重新配置，但不能注入 Final 属性，且注入对象可能被修改。

解决多 Bean 冲突

当同一类型存在多个 Bean 时，直接使用 @Autowired 会报错。Spring 提供了以下几种解决方案：

1. 使用 @Primary

指定该 Bean 为默认实现：

@Component
public class BeanConfig {
    @Primary
    @Bean("u1")
    public User user1() {
        // ...
    }
    
    @Bean
    public User user2() {
        // ...
    }
}

2. 使用 @Qualifier

配合 @Autowired 使用，指定要注入的 Bean 名称：

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

3. 使用 @Resource

按照 Bean 的名称进行注入，通过 name 属性指定：

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

Autowired 与 Resource 的区别

• 来源不同：@Autowired 是 Spring 框架提供的注解；@Resource 是 JDK 提供的注解（Java EE 标准）。
• 注入规则不同：@Autowired 默认按类型（byType）注入，若存在多个需配合 @Qualifier；@Resource 默认按名称（byName）注入，优先匹配 name 属性或属性名。
• 功能差异：@Resource 原生支持 name 参数，可直接指定 Bean 名称；@Autowired 仅支持 required 参数。

在 Spring 4.3+ 后，构造方法注入成为官方推荐，@Autowired 可省略。若项目仅使用 Spring 生态，推荐优先用 @Autowired + @Qualifier；若需跨容器兼容，可考虑 @Resource。