Spring Boot：集成测试中@TestConfiguration未覆盖Bean问题

看起来你的核心问题是测试配置类的configPath Bean没有被正确加载到Spring测试上下文，导致生产环境的Bean被优先使用。虽然你看到测试配置类被实例化了，但它的@Bean方法没有触发，说明这个类并没有被当作配置类来处理，或者没有被正确纳入测试上下文。

下面是具体的原因分析和解决办法：

1. 确保@TestConfiguration被正确引入到测试上下文 #

@TestConfiguration的设计初衷是不会被常规的@ComponentScan自动扫描，它需要显式地被测试类引入，否则Spring不会处理其中的@Bean方法。你可以通过以下方式引入：

方式一：在测试类上使用@Import #

@SpringBootTest
@Import(MyTestConfiguration.class)
public class YourTestClass {
    // 测试代码
}

方式二：通过@SpringBootTest的classes属性指定 #

@SpringBootTest(classes = {MyBeanConfig.class, MyTestConfiguration.class})
public class YourTestClass {
    // 测试代码
}

注意：如果你的主配置类已经被@SpringBootApplication扫描到，这里可以只指定测试配置类，不过显式列出所有需要的配置类更稳妥。

方式三：如果使用@ContextConfiguration #

@ContextConfiguration(classes = MyTestConfiguration.class)
public class YourTestClass {
    // 测试代码
}

2. 验证Bean的加载优先级 #

即使引入了测试配置类，还要确保@Primary注解能生效：

• 确认测试配置类的configPath Bean确实被创建：可以在测试类中注入ApplicationContext，打印所有名称为configPath的Bean：

@Autowired
private ApplicationContext context;

@Test
public void testBeanLoading() {
    String beanName = "configPath";
    if (context.containsBean(beanName)) {
        String path = context.getBean(beanName, String.class);
        System.out.println("Loaded configPath: " + path);
    }
}

如果输出是测试路径，说明配置生效；如果还是生产路径，说明测试配置类的Bean没被加载。

3. 排查是否存在配置类扫描冲突 #

如果你的测试类和生产配置类在同一个包下，或者@ComponentScan的范围包含了生产配置类，可能出现生产Bean先被加载的情况。这时候可以：

• 在测试类上使用@ComponentScan排除生产配置类：

@SpringBootTest
@Import(MyTestConfiguration.class)
@ComponentScan(excludeFilters = @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, value = MyBeanConfig.class))
public class YourTestClass {
    // 测试代码
}

4. 替换String类型Bean的替代方案（可选） #

因为String类型的Bean属于基础类型，Spring在处理时可能存在一些隐含的优先级问题。你可以考虑把路径封装成一个自定义类，避免类型冲突：

自定义配置类 #

public class ConfigPath {
    private String path;

    public ConfigPath(String path) {
        this.path = path;
    }

    public String getPath() {
        return path;
    }
}

修改生产配置类 #

@Configuration
public class MyBeanConfig {
    @Bean
    public ConfigPath configPath() {
        return new ConfigPath("../production/environment/path");
    }
}

修改测试配置类 #

@TestConfiguration
public class MyTestConfiguration {
    @Bean
    @Primary
    public ConfigPath configPath() {
        return new ConfigPath("/test/environment/path");
    }
}

修改组件类 #

@Component
public class MyParsingComponent {
    private String CONFIG_PATH;

    @Autowired
    public void setCONFIG_PATH(ConfigPath configPath) {
        this.CONFIG_PATH = configPath.getPath();
    }
}

这种方式能明确区分Bean的类型，避免基础类型带来的注入歧义。

内容的提问来源于stack exchange，提问作者The Head Rush