Spring Boot集成测试中如何验证流程内指定Bean的方法是否被调用

最常用、对业务代码无侵入的方案是用@SpyBean做方法调用监控，适配绝大多数完整链路集成测试场景，不需要修改生产代码。

方案1：@SpyBean监控（优先推荐） #

@SpyBean是Spring Boot Test提供的测试注解，会把Spring上下文中的原生目标Bean替换为Spy代理对象：既保留原有Bean的全部业务逻辑（流程执行和生产环境完全一致），又能记录所有方法的调用轨迹、入参、返回值，供测试校验使用。

实现步骤 #

1. 确保测试类已经加了@SpringBootTest注解，会加载完整Spring上下文
2. 用@SpyBean注入你要监控的目标Bean，不要用普通@Autowired
3. 执行完整业务流程后，用Mockito的verify方法校验调用情况

代码示例 #

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.mock.mockito.SpyBean;
import static org.mockito.ArgumentMatchers.argThat;
import static org.mockito.Mockito.*;

@SpringBootTest
class FullBusinessFlowTest {

    // 替换容器中原有TargetService实例，保留全部真实逻辑
    @SpyBean
    private TargetService targetService;

    // 注入业务流程入口服务
    @Autowired
    private BizProcessEntryService bizProcessEntryService;

    @Test
    void should_call_target_method_when_flow_execute() {
        // 构造请求参数，触发完整业务流程
        BizRequest request = new BizRequest();
        request.setBizNo("TEST_BIZ_001");
        bizProcessEntryService.startProcess(request);

        // 校验：目标方法被调用恰好1次，且入参bizNo匹配
        verify(targetService, times(1))
                .yourTargetMethod(argThat(param -> "TEST_BIZ_001".equals(param.getBizNo())));
        
        // 其他常用校验场景
        // 校验方法从未被调用：verify(targetService, never()).shouldNotCallMethod();
        // 校验方法至少被调用1次：verify(targetService, atLeastOnce()).yourTargetMethod(any());
    }
}

特殊场景适配 #

如果目标方法是异步执行（加了@Async、或者在子线程中触发），直接校验会因为主线程提前执行校验逻辑导致误判，可以加超时等待：

// 最多等待1秒，直到方法被调用，超时则判定为调用失败
verify(targetService, timeout(1000).times(1)).yourTargetMethod(any());

方案2：自定义AOP切面统计（无Mockito依赖场景适用） #

如果你的测试环境不能引入Mockito依赖，可以通过测试专属的AOP切面记录方法调用情况，同样不会侵入生产代码。

实现步骤 #

1. 在测试路径下写测试专属的配置类，定义切面切你要监控的目标方法，用ThreadLocal记录调用次数、入参信息
2. 测试类中注入该切面，流程执行完成后读取记录做校验
3. 每个用例执行完清空记录，避免用例间互相干扰

代码示例 #

import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;
import org.springframework.boot.test.context.TestConfiguration;
import java.util.*;

@TestConfiguration
@Aspect
public class MethodCallMonitorAspect {
    // 线程私有存储调用记录：key=方法名，value=入参列表
    private final ThreadLocal<Map<String, List<Object[]>>> callRecords = ThreadLocal.withInitial(HashMap::new);

    // 切点配置为你要监控的目标方法全路径
    @Pointcut("execution(* com.your.biz.service.TargetService.yourTargetMethod(..))")
    public void monitorPointcut() {}

    @Around("monitorPointcut()")
    public Object countCall(ProceedingJoinPoint pjp) throws Throwable {
        String methodName = pjp.getSignature().getName();
        callRecords.get().computeIfAbsent(methodName, k -> new ArrayList<>()).add(pjp.getArgs());
        return pjp.proceed();
    }

    // 供测试调用的工具方法：获取指定方法调用次数
    public int getCallTimes(String methodName) {
        return callRecords.get().getOrDefault(methodName, Collections.emptyList()).size();
    }

    // 清空记录，避免线程复用影响其他用例
    public void clearRecords() {
        callRecords.remove();
    }
}

测试类中直接注入MethodCallMonitorAspect，执行完流程后调用getCallTimes判断次数即可，记得在@AfterEach注解的方法中调用clearRecords()清空数据。

注意事项 #

• 不要用@MockBean替换目标Bean：@MockBean生成的代理对象默认不会执行原有业务逻辑，会打断完整业务流程，不符合集成测试的要求
• 如果测试用例并行执行，每个用例执行完后可以调用Mockito.reset(targetService)重置Spy的调用记录，避免用例间数据干扰
• 如果目标方法是被内部调用（类内方法直接调用，没有走代理），不管是Spy还是AOP都无法捕获，需要调整代码结构把目标方法拆分到单独的Bean中，或者通过代理对象调用

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