Spring Boot中@Scheduled定时任务未按配置执行的排查求助

问题背景 #

已在Spring Boot主类添加@EnableScheduling，任务类标注@Component并配置@Scheduled(cron = "*/10 * * * * *")，但10秒执行一次的定时任务未运行。

代码片段 #

主启动类：

@SpringBootApplication
@EnableScheduling
public class RabbitMqPublishSubscribeApp implements CommandLineRunner {

    public static void main(String[] args) {
        SpringApplication.run(RabbitMqPublishSubscribeApp.class, args);
    }
}

任务类：

@Component
public class SchedulerConfiguration {
    @Autowired
    private RabbitMqJobs jobs;

    @Scheduled(cron = "*/10 * * * * *")  
    public void schedulePutQueue() {
        try {
            System.out.println("BEGIN JOB SIGN");           
            jobs.putDataToQueue();

        } catch(Exception e) {          
            ReportLogger.logger.error("Exception main:" +e.getStackTrace().toString(),e);
        }catch (Error er) {
            ReportLogger.logger.error("Error main:" +er.getStackTrace().toString(),er);
        } 
        
    }
}

排查步骤 #

• 确认组件扫描范围：检查SchedulerConfiguration所在包是否在@SpringBootApplication的默认扫描范围内（主类所在包及其子包）。如果不在，需添加@ComponentScan(basePackages = "xxx")指定扫描包，或调整任务类位置。
• 验证任务Bean是否被实例化：在SchedulerConfiguration的构造函数中添加System.out.println("SchedulerConfiguration bean initialized")，启动项目查看控制台是否输出该日志，确认Spring是否成功加载此Bean。
• 检查Cron表达式或改用fixedRate测试：虽然*/10 * * * * *（每10秒执行一次）格式正确，但可临时替换为@Scheduled(fixedRate = 10000)测试，排除Cron表达式解析异常的可能。
• 排查任务执行阻塞或异常：
  1. 先观察控制台是否输出BEGIN JOB SIGN，如果没有，说明任务根本没触发；如果有，说明任务执行到此处但后续出问题。
  2. 若BEGIN JOB SIGN输出但任务未完成，检查jobs.putDataToQueue()是否存在阻塞（比如RabbitMQ连接超时、队列满导致阻塞），或该方法抛出异常但ReportLogger未正确配置导致日志没输出。可临时把异常信息打印到控制台（e.printStackTrace()），确认是否有异常。
• 检查定时任务线程池：Spring默认定时任务线程池是单线程，如果有其他定时任务长期占用线程，会导致当前任务无法执行。可自定义线程池配置：

  @Configuration
  public class SchedulerConfig implements SchedulingConfigurer {
      @Override
      public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
          ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
          scheduler.setPoolSize(5);
          scheduler.setThreadNamePrefix("scheduled-task-");
          scheduler.initialize();
          taskRegistrar.setTaskScheduler(scheduler);
      }
  }
  

• 排除条件注解影响：检查任务类或主类是否添加了@Profile、@Conditional等条件注解，确保当前启动环境满足注解要求。

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