本文详解在使用Resilience4J CircuitBreaker 包裹远程调用时，如何在JUnit测试中可靠捕获传入方法的参数（如Person对象），避免因熔断器状态导致verify()失败。
本文详解在使用resilience4j `circuitbreaker` 包裹远程调用时，如何在junit测试中可靠捕获传入方法的参数（如person对象），避免因熔断器状态导致`verify()`失败。
在基于Spring Boot + Resilience4J的微服务架构中，CircuitBreaker.run()会根据当前熔断器状态决定是否真正执行委托逻辑。默认情况下，测试中注入的@Mock CircuitBreaker并不会触发实际调用——它只是个空壳，既不执行personClient.sendPerson()，也不抛出异常，导致verify(personClient).sendPerson(...)始终失败，报错“Wanted but not invoked”。
根本原因在于：你 mock 的 circuitBreaker 并未实现真实行为，而 run() 方法内部对 sendPerson() 的调用被静默跳过。因此，ArgumentCaptor 无从捕获任何参数。
✅ 正确解法是：在测试中使用真实的 CircuitBreaker 实例（来自 CircuitBreakerRegistry），并强制其处于 CLOSED 状态，确保 run() 内部的 lambda 被真实执行：
@SpringBootTest
class CustomerServiceImplTest {
@Autowired
private CircuitBreakerRegistry circuitBreakerRegistry; // 注入真实注册中心
@InjectMocks
private CustomerServiceImpl customerService;
@Mock
private PersonClient personClient;
private CircuitBreaker testCircuitBreaker;
@BeforeEach
void setUp() {
// 创建专属测试熔断器，并强制开启通行
testCircuitBreaker = circuitBreakerRegistry.circuitBreaker("circuitBreaker");
testCircuitBreaker.transitionToClosedState(); // 关键：必须设为 CLOSED！
}
@Test
void savePerson() {
// 准备测试数据
Person person = new Person();
person.setName("Alice");
person.setAge(20);
// 配置 client 响应（注意：返回值类型需与 sendPerson 签名一致，如 ResponseEntity<void>）
when(personClient.sendPerson(any(Person.class)))
.thenReturn(ResponseEntity.ok().build());
// 执行被测方法
customerService.save(person);
// ✅ 现在 verify 可成功：熔断器已放行，sendPerson 真实被调用
verify(personClient).sendPerson(argThat(p ->
"Alice".equals(p.getName()) && 20 == p.getAge()
));
}
}</void>
⚠️ 注意事项：
- 不要 @Mock CircuitBreaker：mock 后 run() 方法失去行为语义，无法驱动下游调用；
- 必须显式调用 transitionToClosedState()：即使新创建的熔断器默认为 CLOSED，也建议显式设置以增强可读性与可靠性；
- 确保 CircuitBreakerRegistry 已正确配置：测试类需加 @SpringBootTest 或手动构建 CircuitBreakerRegistry（如使用 Resilience4JConfigBuilder）；
- 若 sendPerson() 返回值类型为 Response（非 Spring ResponseEntity），请按实际类型调整 when(...).thenReturn(...)；
- 如需验证熔断场景（如 fallback 路径），可改用 transitionToOpenState() 并验证 throwable -> { ... } 中的日志或返回逻辑。
总结：参数捕获失败的本质是熔断器阻断了执行流。通过在测试中启用真实、可控的熔断器实例，并将其置于 CLOSED 状态，即可恢复完整调用链，使 ArgumentCaptor 和 verify 正常工作——这既是测试技巧，也是对 Resilience4J 行为机制的精准运用。
