Spring中如何对实现同一接口的多个Bean执行同一测试套件

Spring 官方测试体系中最推荐使用 JUnit 5 参数化测试 + 动态配置属性覆盖 的组合方案，无需自定义TestConfiguration即可实现同一套测试用例遍历所有实现类的需求，同时能保证测试逻辑和生产环境的实现类选择逻辑完全对齐。

适用场景 #

你的实现类通过@ConditionalOnProperty注解控制选择，需要完整Spring上下文能力支撑测试。

实现步骤 #

1. 整理@ConditionalOnProperty绑定的配置项的所有合法取值，作为参数化测试的入参源
2. 每个测试用例执行前动态修改上下文配置，触发Spring自动装配对应的实现类
3. 执行通用测试逻辑完成验证
   示例代码如下：

@SpringBootTest
public class CommonServiceTest {
    @Autowired
    private CommonService commonService;

    // 假设@ConditionalOnProperty绑定的配置项为common.service.impl，有效值为aliyun/tencent/huawei
    @ParameterizedTest
    @ValueSource(strings = {"aliyun", "tencent", "huawei"})
    void testAllImpl(String implType) {
        // Spring Boot 2.4+ 支持直接通过DynamicPropertyRegistry动态覆盖配置
        DynamicPropertyRegistry registry = (DynamicPropertyRegistry) ((ConfigurableApplicationContext) SpringContextUtil.getApplicationContext()).getBean(DynamicPropertyRegistry.class);
        registry.add("common.service.impl", () -> implType);

        // 通用测试逻辑，所有实现类都会执行相同的断言
        String result = commonService.uploadFile("test.txt");
        Assertions.assertNotNull(result);
        Assertions.assertTrue(result.startsWith("success:"));
    }
}

轻量场景备选方案 #

如果你的实现类逻辑独立，不需要依赖Spring上下文注入的其他Bean，可以直接显式实例化所有实现类完成遍历测试，执行效率更高：

public class CommonServiceTest {
    // 直接收集所有实现类实例
    private static Stream<CommonService> getAllImpl() {
        return Stream.of(
            new AliyunCommonServiceImpl(),
            new TencentCommonServiceImpl(),
            new HuaweiCommonServiceImpl()
        );
    }

    @ParameterizedTest
    @MethodSource("getAllImpl")
    void testAllImpl(CommonService service) {
        // 通用测试逻辑
        String result = service.uploadFile("test.txt");
        Assertions.assertNotNull(result);
        Assertions.assertTrue(result.startsWith("success:"));
    }
}

方案说明 #

不推荐自定义TestConfiguration的核心原因是：自定义配置需要手动维护实现类注册逻辑，后续新增实现类时必须同步修改测试配置，维护成本高，且容易出现测试选择逻辑和生产@ConditionalOnProperty逻辑不一致的问题。

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