Spring Boot中何时及为何使用自定义@Configuration类与@Bean？

核心逻辑：自动配置只覆盖通用场景 #

Spring Boot的自动配置能帮你搞定大部分常规开发需求，但你的应用总会有个性化、复杂或第三方依赖的场景是自动配置覆盖不到的，这时候就得靠自定义配置来补位或替换默认行为。

具体使用场景 #

1. 引入无自动配置的第三方库 #

很多小众工具、自定义SDK没有官方Spring Starter，自动配置根本不知道怎么帮你把这些类实例化成Bean。这时候你必须自己写@Configuration类，用@Bean手动创建实例，还能灵活注入依赖、设置参数。
示例代码：

@Configuration
public class CustomMqConfig {
    @Bean
    public CustomMqClient mqClient() {
        CustomMqClient client = new CustomMqClient();
        client.setServerAddress("tcp://mq.example.com:5672");
        client.setCredentials("admin", "123456");
        return client;
    }
}

2. 替换自动配置的默认Bean #

自动配置生成的Bean可能不符合你的业务要求——比如默认的数据源连接池参数太小、RestTemplate没有加自定义拦截器。这时候你可以用自定义@Bean替换掉默认Bean，Spring会优先使用你定义的实例（加@Primary注解能明确优先级）。
示例代码：

@Configuration
public class RestTemplateCustomConfig {
    @Bean
    @Primary
    public RestTemplate myRestTemplate() {
        RestTemplate restTemplate = new RestTemplate();
        // 添加自定义日志拦截器
        restTemplate.getInterceptors().add(new RequestLoggingInterceptor());
        return restTemplate;
    }
}

3. 处理复杂的Bean依赖链 #

有些Bean的创建逻辑需要多步骤判断、依赖多个其他Bean，或者根据环境动态调整。自动配置的逻辑是固定的，没法处理这种灵活的依赖关系。
示例代码：

@Configuration
public class StorageConfig {
    @Value("${app.storage.type}")
    private String storageType;

    @Bean
    public StorageService storageService(FileProcessor fileProcessor) {
        switch(storageType) {
            case "local":
                return new LocalStorageService(fileProcessor);
            case "oss":
                return new OssStorageService(fileProcessor);
            default:
                throw new IllegalArgumentException("无效的存储类型");
        }
    }
}

4. 实现条件化配置 #

结合@Conditional系列注解（比如@ConditionalOnProperty、@ConditionalOnMissingBean），你可以让自定义配置只在特定条件下生效，比自动配置的灵活性更高。
示例代码：

@Configuration
@ConditionalOnProperty(name = "app.features.payment.enabled", havingValue = "true")
public class PaymentConfig {
    @Bean
    public PaymentService paymentService() {
        return new AliPayService();
    }
}

@Configuration和@Bean的核心作用 #

• @Configuration：标记这个类是Spring的配置类，告诉Spring要扫描并处理里面的@Bean方法，把方法返回的对象注册到IoC容器中。
• @Bean：定义单个Bean的创建逻辑，让你完全掌控Bean的实例化过程、依赖注入、初始化参数——这是自动配置做不到的精细化控制。

总结 #

自动配置是帮你快速启动项目的“懒人工具”，解决80%的通用问题；自定义@Configuration和@Bean是处理剩下20%个性化、复杂场景的“手动开关”，让你完全掌控Spring容器里的Bean。两者是互补关系，不是替代关系。

内容的提问来源于stack exchange，提问作者abd.alabed