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方式的资料请关注脚本之家其它相关文章!

相关文章

  • Maven 打包跳过Test目录的三种解决方法

    Maven 打包跳过Test目录的三种解决方法

    本文主要介绍了Maven 打包跳过Test目录的三种解决方法,包括修改pom.xml跳过测试、命令行执行跳过、IDEA设置跳过test目录,感兴趣的可以了解一下
    2025-05-05
  • 基于SpringBoot实现代码在线运行工具

    基于SpringBoot实现代码在线运行工具

    这篇文章主要介绍了如何利用SpringBoot实现简单的代码在线运行工具(类似于菜鸟工具),文中的示例代码讲解详细,需要的可以参考一下
    2022-06-06
  • java eclipse 整个项目或包查找只定字符串并替换操作

    java eclipse 整个项目或包查找只定字符串并替换操作

    这篇文章主要介绍了java eclipse 整个项目或包查找只定字符串并替换操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-09-09
  • 实例解析Java关于static的作用

    实例解析Java关于static的作用

    只要是有学过Java的都一定知道static,也一定能多多少少说出一些作用和注意事项。文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-04-04
  • Mybatis-plus中QueryWrapper的多种用法小结

    Mybatis-plus中QueryWrapper的多种用法小结

    本文主要介绍了Mybatis-plus中QueryWrapper的多种用法小结,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-04-04
  • Java工程使用ffmpeg进行音视频格式转换的实现

    Java工程使用ffmpeg进行音视频格式转换的实现

    FFmpeg是一套可以用来记录、转换数字音频、视频,并能将其转化为流的开源计算机程序,本文主要介绍了Java工程使用ffmpeg进行音视频格式转换的实现
    2024-02-02
  • 浅谈Springmvc中的页面跳转问题

    浅谈Springmvc中的页面跳转问题

    这篇文章主要介绍了浅谈Springmvc中的页面跳转问题,具有一定参考价值,需要的朋友可以了解下。
    2017-12-12
  • Java初学者常问的问题(推荐)

    Java初学者常问的问题(推荐)

    本文介绍一些Java初学者常问的问题,很多朋友对可以用%除以一个小数吗? a += b 和 a = a + b 的效果有区别吗? 声明一个数组为什么需要花费大量时间? 为什么Java库不用随机pivot方式的快速排序?等等一系列问题有疑惑,下面就通过本文给大家详细介绍下
    2017-03-03
  • SpringBoot集成RabbitMQ和概念介绍

    SpringBoot集成RabbitMQ和概念介绍

    这篇文章主要介绍了SpringBoot集成RabbitMQ和概念介绍,RabbitMQ即一个消息队列,主要是用来实现应用程序的异步和解耦,同时也能起到消息缓冲,消息分发的作用。更多相关内容需要的小伙伴可以参考一下下面文章内容
    2022-05-05
  • Java创建多线程异步执行实现代码解析

    Java创建多线程异步执行实现代码解析

    这篇文章主要介绍了Java创建多线程异步执行实现代码解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07

最新评论