Spring集成测试：Mock依赖时@Retryable验证遇空指针问题

核心问题排查 #

你遇到的NullPointerException本质是Spring测试上下文没有正确将@MockBean实例注入到MyService中，大概率是测试类缺少必要的Spring Boot测试注解，或者MyService的依赖注入方式不符合Spring规范。

解决方案步骤 #

1. 确保测试类配置正确的Spring Boot测试注解 #

对于JUnit4，必须添加@RunWith(SpringRunner.class)来启动Spring测试上下文，搭配@SpringBootTest加载指定范围的Spring配置：

@RunWith(SpringRunner.class)
@SpringBootTest(classes = {MyService.class}) // 仅加载必要配置类，加快测试启动
public class MyServiceRetryTest {
    // 测试代码
}

注：SpringRunner是SpringJUnit4ClassRunner的别名，功能完全一致；如果需要加载整个应用上下文，可以去掉classes参数。

2. 规范MyService的依赖注入方式 #

Spring无法注入未标记的私有字段，确保你的MyService使用Spring支持的注入方式：

推荐：构造注入（最安全，无依赖隐式问题）

@Service
@EnableRetry
public class MyService {
    private final BeanOne beanOne;
    private final BeanTwo beanTwo;

    // 构造方法注入，Spring会自动匹配并注入MockBean实例
    public MyService(BeanOne beanOne, BeanTwo beanTwo) {
        this.beanOne = beanOne;
        this.beanTwo = beanTwo;
    }

    @Retryable(value = CustomException.class, maxAttempts = 3)
    public void serviceAction() throws CustomException {
        beanOne.doSomething();
        beanTwo.doMoreThings(); // 预期此处抛出异常触发重试
    }
}

备选：字段注入（需添加@Autowired）

如果坚持用字段注入，必须给依赖字段添加@Autowired注解：

@Service
@EnableRetry
public class MyService {
    @Autowired
    private BeanOne beanOne;
    @Autowired
    private BeanTwo beanTwo;

    // 方法同上
}

3. 编写正确的重试逻辑测试用例 #

现在可以正常注入MockBean，模拟异常并验证重试次数：

@RunWith(SpringRunner.class)
@SpringBootTest(classes = {MyService.class})
public class MyServiceRetryTest {

    @Autowired
    private MyService myService;

    @MockBean
    private BeanOne beanOne;

    @MockBean
    private BeanTwo beanTwo;

    @Test
    public void testRetryTriggersOnException() throws CustomException {
        // 模拟BeanTwo的doMoreThings方法抛出预期异常
        doThrow(new CustomException("Test failure"))
                .when(beanTwo).doMoreThings();

        // 执行方法，捕获最终抛出的异常
        try {
            myService.serviceAction();
        } catch (CustomException e) {
            // 验证重试次数：maxAttempts=3，所以方法会被调用3次
            verify(beanTwo, times(3)).doMoreThings();
            verify(beanOne, times(3)).doSomething();
        }
    }
}

额外注意事项 #

• 异常类型匹配：@Retryable默认只重试RuntimeException，如果你的CustomException是受检异常（Checked Exception），必须在@Retryable中显式指定：@Retryable(value = CustomException.class)，同时方法要声明抛出该异常。
• MockBean替换准确性：如果存在多个同类型Bean，需通过@MockBean(name = "beanOne")指定Bean名称，确保替换的是MyService依赖的实例。
• 依赖版本兼容：确保spring-boot-starter-test依赖包含正确的JUnit4、Mockito和Spring Test版本，避免因版本冲突导致上下文初始化失败。

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