保留@RefreshScope解决Spring Boot测试类Bean定义冲突问题

当@RefreshScope和@Configuration同时标注在同一个类上时，Spring会生成两个冲突的Bean定义：一个是原始的配置类Bean，另一个是@RefreshScope创建的代理Bean。两者名称相同，但类型（原始类VS代理类）被Spring判定为不兼容，因此即使开启spring.main.allow-bean-definition-overriding=true也无法解决——该配置仅允许同类型的Bean覆盖，不处理类型不兼容的场景。

以下是几种保留@RefreshScope的前提下解决冲突的可行方案：

方案1：将@RefreshScope移至配置类内部的@Bean方法 #

这是最推荐的做法，通常我们只需要动态刷新配置类中定义的具体Bean，而非配置类本身。将注解从类级别下移到需要刷新的@Bean方法上，避免配置类被代理：

@Configuration
@RequiredArgsConstructor
@Slf4j
public class TestConfig implements ApplicationListener<EnvironmentChangeEvent> {

    // 仅给需要动态刷新的Bean添加@RefreshScope
    @RefreshScope
    @Bean
    public YourConfiguredBean yourConfiguredBean() {
        // 基于配置的Bean初始化逻辑
        return new YourConfiguredBean();
    }

    // 不需要刷新的Bean保持原样
    @Bean
    public AnotherBean anotherBean() {
        return new AnotherBean();
    }

    // 环境变更事件监听逻辑不变
    @Override
    public void onApplicationEvent(EnvironmentChangeEvent event) {
        // 事件处理代码
    }
}

方案2：拆分配置类与刷新Bean #

如果配置类本身需要监听环境变化，同时存在需要刷新的Bean，可以将两者拆分为独立的类：

// 普通配置类，负责事件监听与非刷新Bean注册
@Configuration
@RequiredArgsConstructor
@Slf4j
public class TestConfig implements ApplicationListener<EnvironmentChangeEvent> {

    @Bean
    public AnotherBean anotherBean() {
        return new AnotherBean();
    }

    @Override
    public void onApplicationEvent(EnvironmentChangeEvent event) {
        // 事件处理代码
    }
}

// 专门的刷新Bean配置类
@Configuration
@RefreshScope
public class RefreshableTestConfig {

    @Bean
    public YourConfiguredBean yourConfiguredBean() {
        return new YourConfiguredBean();
    }
}

方案3：针对测试环境单独配置 #

如果不想修改生产代码，可以通过@Profile为测试环境提供一个不带@RefreshScope的配置类版本：

// 生产环境配置类（带@RefreshScope）
@Configuration
@RequiredArgsConstructor
@Slf4j
@RefreshScope
@Profile("!test")
public class TestConfig implements ApplicationListener<EnvironmentChangeEvent> {
    // 完整业务逻辑
}

// 测试环境配置类（不带@RefreshScope）
@Configuration
@RequiredArgsConstructor
@Slf4j
@Profile("test")
public class TestConfigTest implements ApplicationListener<EnvironmentChangeEvent> {
    // 与生产类完全一致的逻辑，仅移除@RefreshScope
}

内容的提问来源于stack exchange，提问作者frans wijaya