Spring Boot集成测试@SpyBean为null 配合Awaitility测试定时任务失效

核心根因 #

你遇到的mailJobFinderTask注入为null的问题，绝大多数是Spring测试上下文未正确加载对应Bean，或者JUnit注解混用导致的，按以下步骤逐一排查即可解决：

排查点1：JUnit版本注解混用 #

• 确认测试类中@Test注解的导入路径是org.junit.jupiter.api.Test（JUnit5），不要和JUnit4的org.junit.Test混用。
• 如果误用了JUnit4的@Test，Spring测试上下文不会启动，所有@Autowired、@SpyBean、@MockBean注入的对象都会是null。

排查点2：配置类扫描范围与定时开关配置 #

• 你当前用@SpringJUnitConfig(SchedulerConfig.class)只加载了指定配置类，需要确认SchedulerConfig满足以下要求：
  1. 加了@ComponentScan注解，且扫描范围包含MailJobFinderTask所在的包路径
  2. 加了@EnableScheduling注解开启定时任务能力，否则定时任务不会被注册到Spring上下文
     正确的配置类示例：

  @Configuration
  @ComponentScan(basePackages = "com.xxx.xxx.task") // 替换为你定时任务类所在的包
  @EnableScheduling
  public class SchedulerConfig {
  }
  

• 如果你切换用@SpringBootTest，需要明确指定启动类，避免扫描范围不匹配：

  @SpringBootTest(classes = 你的项目主启动类.class)
  public class MailJobFinderTaskIT {
  

排查点3：Bean注册限制检查 #

• 检查MailJobFinderTask类上是否加了@ConditionalOnProperty、@Profile等条件类注解，限制了只有特定环境/配置下才注册Bean，导致测试环境不会加载该实例。
• 确认MailJobFinderTask继承的SuppressedLogPoller不是抽象类，且子类存在可被Spring调用的构造函数，没有未注入的必填构造参数，否则会导致Bean实例化失败。

排查点4：调试确认Bean注册状态 #

如果以上几步都没问题，在测试类中加入如下代码，确认Bean是否被正确加载到上下文：

@Autowired
private ApplicationContext applicationContext;

@Test
public void checkBeanExists() {
    // 如果该行抛出NoSuchBeanDefinitionException，说明Bean没被扫描到，回到前几步检查配置
    MailJobFinderTask contextBean = applicationContext.getBean(MailJobFinderTask.class);
    System.out.println("上下文注册的Bean：" + contextBean);
    System.out.println("@SpyBean注入的实例：" + mailJobFinderTask);
}

验证修复 #

确认Bean注入正常后，你的原有测试逻辑不需要修改，运行即可验证定时任务的执行次数是否符合预期。

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