当前位置：首页 > news >正文

Spring 创建 Bean 的 8 种主要方式

news 2025/8/18 13:31:54

Spring（尤其是 Spring Boot）提供了多种方式来让容器创建和管理 Bean。@Component、@Configuration + @Bean、@EnableConfigurationProperties 都是常见方式。

下面我为你系统地梳理 Spring 创建 Bean 的所有主要方式，并说明它们的使用场景和区别。

✅ 一、Spring 创建 Bean 的 8 种主要方式

方式	注解/方法	适用场景
1	`@Component` 及其衍生注解	扫描普通类为 Bean
2	`@Configuration` + `@Bean`	手动配置第三方类或复杂对象
3	`@EnableConfigurationProperties` + `@ConfigurationProperties`	将配置文件映射为 Bean
4	`@Import`	导入配置类或直接注册 Bean
5	实现 `FactoryBean<T>`	创建复杂或条件性对象
6	使用 `@Conditional` 系列注解	条件化注册 Bean
7	编程式注册：`BeanDefinitionRegistryPostProcessor`	动态注册 Bean（高级）
8	XML 配置（传统方式）	老项目兼容

1. `@Component` 及其衍生注解（最常用）

@Component
@Service
@Repository
@Controller
@RestController
@Configuration // @Configuration 也是 @Component

原理：配合 @ComponentScan，Spring 会扫描这些类并注册为 Bean。
适用：你自己写的业务类（Service、DAO、Controller 等）。

@Service
public class UserService {public void save() { ... }
}

✅ 自动注册为 userService Bean。

2. `@Configuration` + `@Bean`（手动注册）

用于注册不能加 @Component 的类（如第三方库的类）。

@Configuration
public class RedisConfig {@Beanpublic RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {RedisTemplate<String, Object> template = new RedisTemplate<>();template.setConnectionFactory(factory);return template;}
}

适用：数据源、RedisTemplate、RabbitMQ、RocketMQ、OkHttp、HttpClient 等第三方组件。

3. `@EnableConfigurationProperties` + `@ConfigurationProperties`

将 application.yml 中的配置自动绑定为 Bean。

app:title: MyAppversion: 1.0.0

@Component
@ConfigurationProperties(prefix = "app")
public class AppProperties {private String title;private String version;// getter/setter
}

@Configuration
@EnableConfigurationProperties(AppProperties.class)
public class AppConfig {
}

✅ AppProperties 会被 Spring 创建并注入配置值，且可被 @Autowired。

💡 在 Spring Boot 2.2+ 中，@EnableConfigurationProperties 通常可以省略，只要类加了 @ConfigurationProperties 并被扫描到即可。

4. `@Import`（导入配置类或直接注册）

三种用法：

(1) 导入 `@Configuration` 类

@Import(DatabaseConfig.class)
@SpringBootApplication
public class Application { }

(2) 导入 `@Component` 类

@Import(UserService.class)

(3) 导入 `ImportSelector` 或 `ImportBeanDefinitionRegistrar`

@Import(MyImportSelector.class)
public class Application { }public class MyImportSelector implements ImportSelector {@Overridepublic String[] selectImports(AnnotationMetadata importingClassMetadata) {return new String[]{MyService.class.getName()};}
}

✅ 用于实现“条件导入”、“SPI 扩展”等高级功能。

5. 实现 `FactoryBean<T>`（创建复杂对象）

当你需要复杂的创建逻辑时使用。

public class MyFactoryBean implements FactoryBean<MyService> {@Overridepublic MyService getObject() throws Exception {MyService service = new MyService();service.init(); // 复杂初始化return service;}@Overridepublic Class<?> getObjectType() {return MyService.class;}@Overridepublic boolean isSingleton() {return true;}
}

@Component
public class MyFactoryBean { } // Spring 会调用 getObject() 创建 MyService Bean

✅ 适合创建代理对象、动态对象、SPI 实现等。

6. `@Conditional` 系列注解（条件化注册）

只有满足条件时才创建 Bean。

@Bean
@ConditionalOnMissingBean(DataSource.class)
public DataSource dataSource() {return new HikariDataSource();
}

常见条件注解：

注解	说明
`@ConditionalOnClass`	类路径存在某个类
`@ConditionalOnMissingBean`	容器中没有某个 Bean
`@ConditionalOnProperty`	配置文件中有某个属性
`@ConditionalOnWebApplication`	是 Web 应用
`@ConditionalOnExpression`	SpEL 表达式为 true

✅ 这是 Spring Boot 自动配置的核心机制。

7. 编程式注册：`BeanDefinitionRegistryPostProcessor`

最强大、最灵活的方式，可以在容器启动时动态注册 Bean。

@Component
public class DynamicBeanRegistrar implements BeanDefinitionRegistryPostProcessor {@Overridepublic void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {BeanDefinitionBuilder builder = BeanDefinitionBuilder.rootBeanDefinition(UserService.class);AbstractBeanDefinition definition = builder.getBeanDefinition();registry.registerBeanDefinition("userService", definition);}@Overridepublic void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {// do nothing}
}

✅ 适合插件化、动态加载、AOP 增强等场景。

8. XML 配置（传统方式）

<bean id="userService" class="com.example.UserService"/>

ApplicationContext context = new ClassPathXmlApplicationContext("beans.xml");

❌ 现在已不推荐，但在老项目中仍可见。

✅ 总结对比

方式	何时使用	推荐度
`@Component`	自己写的类	⭐⭐⭐⭐⭐
`@Configuration` + `@Bean`	第三方类、复杂配置	⭐⭐⭐⭐⭐
`@ConfigurationProperties`	配置文件映射	⭐⭐⭐⭐
`@Import`	模块化导入	⭐⭐⭐
`FactoryBean`	复杂对象创建	⭐⭐⭐
`@Conditional`	条件注册	⭐⭐⭐⭐（自动配置核心）
`BeanDefinitionRegistryPostProcessor`	动态注册	⭐⭐（高级）
XML	老项目	⭐