Spring创建Bean的八种主要方式详解

 更新时间:2025年08月19日 09:00:34   作者:小兔兔吃萝卜  
Spring(尤其是 Spring Boot)提供了多种方式来让容器创建和管理 Bean,@Component、@Configuration + @Bean、@EnableConfigurationProperties 都是常见方式,下面我为你系统地梳理 Spring 创建 Bean 的所有主要方式,并说明它们的使用场景和区别,需要的朋友可以参考下

引言

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(高级)
8XML 配置(传统方式)老项目兼容

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 {
    
    @Bean
    public 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: MyApp
  version: 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 {
    @Override
    public String[] selectImports(AnnotationMetadata importingClassMetadata) {
        return new String[]{MyService.class.getName()};
    }
}

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

5. 实现 FactoryBean<T>(创建复杂对象)

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

public class MyFactoryBean implements FactoryBean<MyService> {

    @Override
    public MyService getObject() throws Exception {
        MyService service = new MyService();
        service.init(); // 复杂初始化
        return service;
    }

    @Override
    public Class<?> getObjectType() {
        return MyService.class;
    }

    @Override
    public 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 应用
@ConditionalOnExpressionSpEL 表达式为 true

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

7. 编程式注册:BeanDefinitionRegistryPostProcessor

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

@Component
public class DynamicBeanRegistrar implements BeanDefinitionRegistryPostProcessor {

    @Override
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {
        BeanDefinitionBuilder builder = BeanDefinitionBuilder.rootBeanDefinition(UserService.class);
        AbstractBeanDefinition definition = builder.getBeanDefinition();
        registry.registerBeanDefinition("userService", definition);
    }

    @Override
    public 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老项目

最佳实践建议

  1. 优先使用 @Component@Bean,简单直接;
  2. 配置参数用 @ConfigurationProperties,类型安全;
  3. 避免重复注册,善用 @ConditionalOnMissingBean
  4. 复杂逻辑用 @ImportFactoryBean
  5. 动态场景用 BeanDefinitionRegistryPostProcessor(谨慎使用)。

以上就是Spring创建Bean的八种主要方式详解的详细内容,更多关于Spring创建Bean方式的资料请关注脚本之家其它相关文章!

相关文章

  • java用扑克牌计算24点

    java用扑克牌计算24点

    这篇文章主要为大家详细介绍了java实现24点扑克牌游戏,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-03-03
  • spring-boot-maven-plugin插件爆红问题及解决方案

    spring-boot-maven-plugin插件爆红问题及解决方案

    这篇文章主要介绍了spring-boot-maven-plugin插件爆红问题及解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-05-05
  • JAVA中Object的常用方法

    JAVA中Object的常用方法

    JAVA中Object是所有对象的顶级父类,存在于java.lang包中,这个包不需要我们手动导包,本文通过实例代码介绍JAVA中Object的常用方法,感兴趣的朋友一起看看吧
    2023-11-11
  • SpringBoot整合Mongodb实现增删查改的方法

    SpringBoot整合Mongodb实现增删查改的方法

    这篇文章主要介绍了SpringBoot整合Mongodb实现简单的增删查改,MongoDB是一个以分布式数据库为核心的数据库,因此高可用性、横向扩展和地理分布是内置的,并且易于使用。况且,MongoDB是免费的,开源的,感兴趣的朋友跟随小编一起看看吧
    2022-05-05
  • Java 获取指定日期的实现方法总结

    Java 获取指定日期的实现方法总结

    以下是对Java中获取指定日期的实现方法进行了归纳总结,需要的朋友可以参考下
    2013-07-07
  • JAVA实现的简单万年历代码

    JAVA实现的简单万年历代码

    这篇文章主要介绍了JAVA实现的简单万年历代码,涉及Java日期操作的相关技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-10-10
  • Mybatis如何传入多个参数的实现代码

    Mybatis如何传入多个参数的实现代码

    这篇文章主要介绍了Mybatis如何传入多个参数的实现代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-12-12
  • java 字符串反转的实例详解

    java 字符串反转的实例详解

    这篇文章主要介绍了java 字符串反转的实例详解的相关资料,这里提供实现代码帮助大家学习参考这部分内容,需要的朋友可以参考下
    2017-08-08
  • 使用Java动态创建Flowable会签模型的示例代码

    使用Java动态创建Flowable会签模型的示例代码

    动态创建流程模型,尤其是会签(Parallel Gateway)模型,是提升系统灵活性和响应速度的关键技术之一,本文将通过Java编程语言,深入探讨如何在运行时动态地创建包含会签环节的Flowable流程模型,需要的朋友可以参考下
    2024-05-05
  • 快速入门介绍Java中强大的String.format()

    快速入门介绍Java中强大的String.format()

    这篇文章主要给大家介绍了如何快速入门介绍Java中强大的String.format()的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。
    2018-03-03

最新评论