Spring Boot 对定时任务的支持来自 Spring 框架的 spring-context 模块，整合步骤非常简单。首先需要在启动类或者任意配置类上添加 @EnableScheduling 注解，该注解会向容器中注册一个 ScheduledAnnotationBeanPostProcessor 后置处理器。容器初始化 bean 时，这个后置处理器会扫描所有 bean 的方法，找到带有 @Scheduled 注解的方法，并为每个方法创建对应的定时任务注册到任务调度器中。
@EnableScheduling 与 @Scheduled 的基本整合方式
业务方法上的 @Scheduled 支持三种触发方式：fixedRate 表示从上一次任务开始时间计算固定间隔，fixedDelay 表示从上一次任务结束时间计算延迟，cron 则使用 Cron 表达式灵活定义触发时间。下面是一个典型示例，启动类开启调度，服务类中安排一个每隔五秒执行一次的任务。
@SpringBootApplication
@EnableScheduling
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
@Component
public class ReportJob {
@Scheduled(fixedRate = 5000)
public void generateReport() {
System.out.println("生成统计报表：" + System.currentTimeMillis());
}
}
这段代码中，启动类上的 @EnableScheduling 让整个应用获得任务调度能力，@Scheduled(fixedRate = 5000) 表示每五秒触发一次 generateReport 方法。需要注意的是，fixedRate 不会等待上一次任务结束，如果任务执行时间超过间隔，下一次任务会在上一次结束后立即开始，可能造成实际间隔小于设定值。对于耗时任务，更适合使用 fixedDelay 或者配置自定义线程池。
自定义线程池避免默认单线程阻塞
Spring Boot 默认使用单线程的 TaskScheduler 执行所有 @Scheduled 任务。这意味着如果某个任务长时间运行，后续任务只能排队等待，轻则延迟触发，重则整个调度队列积压。比如一个定时清理任务需要十分钟，而另一个心跳任务需要每三十秒执行一次，单线程模式下心跳任务会严重滞后甚至丢失。
要解决这个问题，可以实现 SchedulingConfigurer 接口，在 configureTasks 方法中注册一个自定义线程池。示例代码如下：
@Configuration
@EnableScheduling
public class ScheduleConfig implements SchedulingConfigurer {
@Override
public void configureTasks(ScheduledTaskRegistrar registrar) {
registrar.setScheduler(taskExecutor());
}
@Bean
public ThreadPoolTaskScheduler taskExecutor() {
ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
scheduler.setPoolSize(10);
scheduler.setThreadNamePrefix("scheduled-task-");
scheduler.setAwaitTerminationSeconds(60);
scheduler.setWaitForTasksToCompleteOnShutdown(true);
scheduler.initialize();
return scheduler;
}
}
上面配置创建了一个大小为 10 的线程池，线程名称以 scheduled-task- 开头。这十个线程可以并行执行不同的定时任务，即使某个任务阻塞，也不会影响其他任务的调度。注意 setWaitForTasksToCompleteOnShutdown(true) 表示应用关闭时等待任务执行完毕，避免任务被强制中断导致数据不一致，setAwaitTerminationSeconds(60) 则设置最多等待六十秒。
除了直接实现 SchedulingConfigurer，还可以在 Spring Boot 配置文件中通过 spring.task.scheduling.pool.size 和 spring.task.scheduling.thread-name-prefix 快速调整线程池大小，但这种方式只适用于较新的 Spring Boot 版本。如果还需要更细粒度的拒绝策略、队列容量等参数，自定义 ThreadPoolTaskScheduler 是更灵活的选择。
动态管理定时任务与常见坑点
静态的 @Scheduled 注解只能把触发规则写在代码里，修改 cron 表达式需要改代码并重新部署。很多业务场景希望在运行期间调整任务时间，例如管理员在后台将每日报表从早上六点改为八点。这可以通过直接操作 ThreadPoolTaskScheduler 实现，核心思路是取消旧的 ScheduledFuture，然后调用 schedule 方法重新注册任务。
下面演示一个动态调度的简单控制器，它保存任务调度器和任务句柄，并提供接口更新 cron 表达式：
@RestController
public class DynamicJobController {
private final ThreadPoolTaskScheduler taskScheduler;
private ScheduledFuture future;
public DynamicJobController(ThreadPoolTaskScheduler taskScheduler) {
this.taskScheduler = taskScheduler;
}
@PostMapping("/job/start")
public String startJob(@RequestParam String cron) {
if (future != null) {
future.cancel(true);
}
future = taskScheduler.schedule(() -> {
System.out.println("动态任务执行：" + System.currentTimeMillis());
}, new CronTrigger(cron));
return "任务已启动";
}
@PostMapping("/job/stop")
public String stopJob() {
if (future != null) {
future.cancel(false);
future = null;
}
return "任务已停止";
}
}
上面的代码中，每次调用启动接口都会先取消旧任务，再根据传入的 cron 表达式创建新的 CronTrigger 并调度任务。这种方式灵活，但要注意线程安全问题，多个并发请求同时操作同一个 future 可能导致状态混乱，实际项目中需要加锁或者将句柄集中管理。
使用 @Scheduled 时还有几个容易忽略的限制。第一，方法必须是无参且返回 void，否则启动阶段会抛出 BeanInitializationException。第二，同一个类中直接调用 @Scheduled 方法不会触发调度逻辑，因为调用的是原始对象而非 Spring 代理。第三，cron 表达式只支持六位或七位格式，分别对应秒、分、时、日、月、周，第七位是年，写错位数不会生效。第四，任务方法中如果抛出未捕获异常，默认会终止该任务后续的调度，建议在方法内部用 try-catch 处理异常。掌握这些细节后，Spring Boot 的定时任务整合才能在生产环境中稳定运行。
Spring Boot定时任务EnableScheduling修改时间：2026-08-23 07:29:15