Spring @Bean注解用法

目录

• 1. 基础逻辑：按类型匹配（byType）
• 2. 多个子类Bean的情况：类型冲突与解决
  • 方式1：使用@Primary指定优先Bean
  • 方式2：使用@Qualifier指定Bean名称
• 总结

在Spring框架中，当一个@Bean方法的入参需要注入依赖时（如你示例中的DbStateMachineConfig），其依赖解析逻辑遵循Spring的依赖注入规则，核心是“按类型匹配，按名称兜底”。

1. 基础逻辑：按类型匹配（byType）

Spring会先根据入参的类型（DbStateMachineConfig） 在容器中查找匹配的Bean。

• 如果容器中只有一个类型为DbStateMachineConfig或其子类的Bean（因为子类是父类的“is-a”关系，符合类型匹配），Spring会直接将该Bean注入到方法参数中。
• 例如：如果有一个MyDbStateMachineConfig extends DbStateMachineConfig，且它被注册为Bean，那么Spring会认为它是DbStateMachineConfig类型的候选者，直接注入。

2. 多个子类Bean的情况：类型冲突与解决

如果容器中存在多个DbStateMachineConfig的子类Bean（即多个候选者），仅按类型无法唯一确定，此时Spring会抛出NoUniqueBeanDefinitionException异常。

需要通过以下方式手动指定具体使用哪个Bean：

方式1：使用@Primary指定优先Bean

在多个子类Bean中，给需要优先注入的子类Bean添加@Primary注解。当类型匹配存在多个候选者时，Spring会优先选择被@Primary标注的Bean。

示例：

// 子类1：被@Primary标注，优先注入
@Bean
@Primary
public class FirstDbConfig extends DbStateMachineConfig { ... }// 子类2：不标注@Primary
@Bean
public class SecondDbConfig extends DbStateMachineConfig { ... }// 此时，stateMachineEngine方法会注入FirstDbConfig

方式2：使用@Qualifier指定Bean名称

通过@Qualifier注解明确指定需要注入的Bean的名称（默认是类名首字母小写，如firstDbConfig、secondDbConfig），实现“按名称匹配”。

示例：

// 子类1：指定Bean名称为"firstConfig"
@Bean("firstConfig")
public class FirstDbConfig extends DbStateMachineConfig { ... }// 子类2：指定Bean名称为"secondConfig"
@Bean("secondConfig")
public class SecondDbConfig extends DbStateMachineConfig { ... }// 在入参上通过@Qualifier指定名称
@Bean
public ProcessCtrlStateMachineEngine stateMachineEngine(@Qualifier("firstConfig") DbStateMachineConfig dbStateMachineConfig
) {...
}
// 此时，注入的是名称为"firstConfig"的FirstDbConfig

总结

• Spring默认按类型解析@Bean方法的入参依赖，子类Bean会被视为父类类型的候选者。
• 多个子类Bean存在时，必须通过@Primary（指定优先）或@Qualifier（指定名称）解决冲突，否则会抛出类型不唯一的异常。