SpringBoot使用@Configuration集中管理Bean的实战步骤

时间：2026-04-21

一、核心概念

在SpringBoot的世界里，告别繁琐的XML配置早已成为共识。那么，如何优雅地集中管理应用中的所有Bean呢？答案就在@Configuration这个注解上。它本质上是一个“代码化”的配置文件，SpringBoot启动时会自动扫描并加载它，从而将所有第三方Bean、自定义Bean的创建和管理都收归一处，实现真正的模块化与清晰化。

围绕它的核心概念其实非常简洁：

@Configuration：这是一个类级别的注解。把它标在类上，就等于告诉Spring：“嗨，这是一个配置类，我所有的Bean定义都在这里了。”
@Bean：这是方法级别的注解。它的魔法在于，被它标记的方法的返回值，就会直接成为一个受Spring容器托管的Bean对象。默认情况下，方法名就是Bean的名称。
核心优势：这样做的好处显而易见——所有Bean的创建逻辑集中在一处，一目了然；它天然支持依赖注入和配置属性注入；代码的可读性和可维护性相比分散的注解或XML，有了质的提升。

SpringBoot使用@Configuration集中管理Bean的实战步骤

二、实战步骤

1. 基础环境

准备一个标准的SpringBoot项目即可，无需引入任何额外依赖。@Configuration和@Bean注解都包含在Spring的核心容器模块中，开箱即用。

2. 创建统一配置类

这是最关键的一步。通常，我们会在项目中创建一个config包，然后在这个包下编写我们的全局配置类。这个类的使命，就是集中注册所有需要的Bean，无论是你自定义的业务对象，还是无法直接控制的第三方工具类。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import ja va.util.concurrent.ExecutorService;
import ja va.util.concurrent.Executors;

/**
 * 全局Bean配置类：集中管理所有Bean对象
 */
@Configuration // 核心注解：标记为配置类
public class GlobalBeanConfig {

    // ==================== 1. 管理自定义 Bean ====================
    /**
     * 创建自定义 UserService Bean（也可以用 @Service 注解，这里演示配置类方式）
     * @return Bean 对象
     */
    @Bean // 方法名 userService 就是 Bean 的名称
    public UserService userService() {
        return new UserService();
    }

    // ==================== 2. 管理第三方工具类 Bean ====================
    /**
     * 注册线程池 Bean（第三方类，无法加 @Component，必须用配置类管理）
     */
    @Bean
    public ExecutorService threadPool() {
        return Executors.newFixedThreadPool(5);
    }

    // ==================== 3. 带依赖注入的 Bean ====================
    /**
     * 创建 OrderService Bean，依赖上面的 userService Bean
     */
    @Bean
    public OrderService orderService(UserService userService) { // 自动注入已注册的 Bean
        OrderService orderService = new OrderService();
        // 手动注入依赖
        orderService.setUserService(userService);
        return orderService;
    }
}

3. 配套的业务类（无注解，纯Ja va类）

注意看，这里的业务类就是最纯粹的Ja va类，没有任何Spring注解。它们的生命周期完全由上面的配置类掌控。

// 自定义业务类（无需加 @Service/@Component，由配置类统一注册）
public class UserService {
    public String getUserInfo() {
        return "用户信息：集中管理的Bean";
    }
}

public class OrderService {
    private UserService userService;

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

    public String getOrderInfo() {
        return "订单信息，依赖：" + userService.getUserInfo();
    }
}

4. 测试使用集中管理的 Bean

在控制器或其他组件中，使用起来和普通的Spring Bean没有任何区别，直接通过@Autowired或@Resource注入即可。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import ja vax.annotation.Resource;

@RestController
public class TestController {

    // 注入配置类中创建的 Bean
    @Resource
    private UserService userService;

    @Resource
    private OrderService orderService;

    @Resource
    private ExecutorService threadPool;

    @GetMapping("/test")
    public String test() {
        // 测试自定义Bean
        System.out.println(userService.getUserInfo());
        // 测试依赖注入的Bean
        System.out.println(orderService.getOrderInfo());
        // 测试第三方Bean
        threadPool.execute(() -> System.out.println("线程池Bean执行成功"));
        return "Bean 集中管理测试成功";
    }
}

三、高级用法

1. 给 Bean 指定名称（默认是方法名）

默认用方法名作为Bean名虽然方便，但有时我们需要更明确的标识。这时，可以通过@Bean注解的name或value属性来指定。

@Bean(name = "customUserService") // 指定Bean名称
public UserService userService() {
    return new UserService();
}

注入时，相应地指定名称即可：

@Resource(name = "customUserService")
private UserService userService;

2. 配置多环境/模块化管理Bean

把所有Bean都堆在一个配置类里，对于大型项目显然不是好主意。更佳实践是按功能模块进行拆分，形成多个专注的配置类。

DataSourceConfig：专门管理数据库连接池相关Bean。
ThreadPoolConfig：专门管理线程池相关Bean。
RedisConfig：专门管理Redis客户端和模板Bean。

完全不用担心，SpringBoot会自动扫描所有带@Configuration的类，并将它们整合起来。

3. 读取配置文件注入 Bean

配置类的强大之处在于它能与外部配置文件（如application.yml）无缝结合，实现Bean的动态创建。

首先，在application.yml中定义配置：

thread:
  core: 5

然后，在配置类中注入这个值，并用它来构造Bean：

import org.springframework.beans.factory.annotation.Value;

@Configuration
public class ThreadPoolConfig {
    @Value("${thread.core}")
    private Integer corePoolSize;

    @Bean
    public ExecutorService threadPool() {
        return Executors.newFixedThreadPool(corePoolSize);
    }
}

4. Bean 销毁方法（资源释放）

对于像线程池、数据库连接池这类持有重要资源、需要在应用关闭时优雅释放的Bean，我们可以指定其销毁方法。

@Bean(destroyMethod = "shutdown") // 指定销毁方法
public ExecutorService threadPool() {
    return Executors.newFixedThreadPool(5);
}

这样，当Spring容器关闭时，它会自动调用该Bean的shutdown()方法，确保资源被正确释放。

四、总结

掌握了@Configuration，你就掌握了SpringBoot中Bean管理的“总开关”。我们来快速回顾一下要点：

@Configuration = 现代配置文件：它是集中、统一管理Bean的终极方案，是SpringBoot推崇的“零XML”配置理念的核心实践。
@Bean = Bean注册器：一个简单的注解，就能将方法返回的对象托付给Spring容器管理。
最佳适用场景：
- 管理那些无法直接添加@Component注解的第三方类库对象，比如线程池、数据源、各种客户端模板。
- Bean的创建过程需要自定义初始化逻辑，无法通过简单构造完成。
- 追求项目结构的清晰度，希望将所有Bean的创建逻辑集中管理，便于统一维护和查阅。
依赖注入依然流畅：在配置类的@Bean方法中，你可以直接通过方法参数声明依赖，Spring会自动将容器中已存在的Bean注入进来，整个过程非常自然。