本文介绍在不启动完整 spring 上下文的前提下，通过构造函数注入方式为被测组件提供自定义的、非 mock 的依赖 bean（如 `@qualifier("fooconsumers")` 的 `list
在 Spring 单元测试中，若目标是验证某个 @Component（如 MyHealthIndicator）的行为，而它依赖一个由配置类声明的命名 Bean（如 @Bean(name = "FooConsumers") List
更轻量、更可控、也更符合单元测试原则的做法是：绕过 Spring 容器，采用纯 Mockito 驱动的构造注入测试模式。
✅ 正确实践：面向构造函数的测试设计
首先，确保被测类支持构造函数注入（推荐且 Spring 原生支持）。修改 MyHealthIndicator，显式暴露带 List
将 Spring Boot 2.7 项目升级到 Spring Boot 3.5 的实战流程，覆盖版本基线、依赖坐标替换、Jakarta 迁移、配置兼容、异步上下文传递改造与验证门禁。用于企业多模块 Maven 项目升级与排障。
@Component
@ConditionalOnEnabledHealthIndicator("barIndicator")
@RequiredArgsConstructor
public class MyHealthIndicator implements HealthIndicator {
private final List<JmsConsumer> jmsConsumersList; // final + 构造注入，清晰、安全、易测
@Override
public Health health() {
int connectedCount = 0;
Map<String, Object> detailsMap = new HashMap<>();
for (JmsConsumer consumer : jmsConsumersList) { // 不再可能为 null
if (consumer.isConnected()) {
connectedCount++;
}
detailsMap.put(consumer.getAlias(), consumer.isConnected());
}
return Health.up().withDetails(detailsMap).build();
}
}接着，在测试类中彻底放弃 SpringExtension，改用 MockitoExtension，并通过手动构造传入预设的测试数据：
@ExtendWith(MockitoExtension.class)
class MyHealthIndicatorTest {
@Mock
JmsConsumer jmsConsumer1;
@Mock
JmsConsumer jmsConsumer2;
private MyHealthIndicator myHealthIndicator;
@BeforeEach
void setup() {
// 手动构造：注入你完全掌控的 List 实例
List<JmsConsumer> testConsumers = List.of(jmsConsumer1, jmsConsumer2);
myHealthIndicator = new MyHealthIndicator(testConsumers);
}
@Test
void testStatusUpAll() {
// 配置 mock 行为
Mockito.when(jmsConsumer1.getAlias()).thenReturn("jmsConsumer1");
Mockito.when(jmsConsumer1.isConnected()).thenReturn(true);
Mockito.when(jmsConsumer2.getAlias()).thenReturn("jmsConsumer2");
Mockito.when(jmsConsumer2.isConnected()).thenReturn(true);
// 执行被测方法
Health result = myHealthIndicator.health();
// 断言
assertThat(result.getStatus()).isEqualTo(Status.UP);
assertThat(result.getDetails()).containsEntry("jmsConsumer1", true)
.containsEntry("jmsConsumer2", true);
}
}⚠️ 关键注意事项
- 不要混用 @SpringBootTest / @ContextConfiguration 和手动 new 实例：二者属于不同测试范式。一旦选择构造注入测试，就应完全脱离 Spring 容器初始化逻辑，否则 @Inject 字段仍为空，@Bean 方法也不会被扫描执行。
- @Mock 必须配合 @ExtendWith(MockitoExtension.class)：确保 Mockito 自动完成字段注入和生命周期管理；若用 MockitoAnnotations.openMocks(this)，需自行 close()。
- 优先使用 List.of() 或 Arrays.asList()：比 new ArrayList() + add() 更简洁；若需可变列表（如后续要 remove()），再用 new ArrayList(...) 包装。
- 避免“伪集成”陷阱：试图在 @SpringBootTest 中用 @TestConfiguration 覆盖 @Bean 是可行的，但会引入不必要的上下文开销，且易受 @Primary、@Profile 等影响；对纯逻辑验证而言，构造注入更直接、更可靠。
✅ 总结
单元测试的核心是隔离被测对象、控制所有输入、验证明确输出。对于 MyHealthIndicator 这类职责单一、依赖明确的组件，与其费力模拟 Spring Bean 注册机制，不如拥抱构造函数注入——它让依赖显式化、测试扁平化、代码更健壮。此方案零启动延迟、零上下文干扰、零 NPE 风险，是 Spring 生态下高效单元测试的推荐实践。
