Spring Boot 定时任务的使用
前言
在实际开发中，我们经常需要实现定时任务的功能，例如每天凌晨执行数据清理、定时发送邮件等。Spring Boot 提供了非常便捷的方式来实现定时任务，本文将详细介绍如何在 Spring Boot 中使用定时任务。
一、Spring Boot 定时任务简介
Spring Boot 使用@Scheduled注解来实现定时任务功能，底层基于 Spring 的任务调度模块（Spring Task）。通过该注解，我们可以很方便地定义周期性执行的任务。
二、启用定时任务
首先，在 Spring Boot 应用中要启用定时任务，需要在主启动类或配置类上添加 @EnableScheduling 注解：
@SpringBootApplication
@EnableScheduling
public class ScheduledTaskApplication {public static void main(String[] args) {SpringApplication.run(ScheduledTaskApplication.class, args);}
}
三、创建定时任务
接下来，我们可以通过 @Scheduled 注解来定义定时任务方法。这些方法必须是无参的，并且返回类型为 void。
@Component
public class ScheduledTasks {// 每隔5秒执行一次@Scheduled(fixedRate = 5000)public void runEveryFiveSeconds() {String time = LocalDateTime.now().format(DateTimeFormatter.ISO_DATE_TIME);System.out.println("Fixed rate task - Current time: " + time);}// 每天上午10:00执行@Scheduled(cron = "0 0 10 * * ?")public void runAtTenAM() {String time = LocalDateTime.now().format(DateTimeFormatter.ISO_DATE_TIME);System.out.println("Daily task at 10 AM - Current time: " + time);}// 初始延迟3秒后执行，之后每隔10秒执行一次@Scheduled(initialDelay = 3000, fixedDelay = 10000)public void delayedTask() {String time = LocalDateTime.now().format(DateTimeFormatter.ISO_DATE_TIME);System.out.println("Delayed task - Current time: " + time);}
}
四、@Scheduled 支持的参数
| 参数名 | 描述 |
|---|---|
| fixedDelay | 上次任务执行完后，间隔固定时间再次执行（毫秒） |
| fixedRate | 固定频率执行，无论上次任务是否完成 |
| initialDelay | 初始延迟时间（毫秒），仅在首次执行时生效 |
| cron | 使用 cron 表达式指定执行时间 |
Cron 表达式说明
Cron 表达式由6或7个字段组成，分别表示：
- 秒（0–59）
- 分（0–59）
- 小时（0–23）
- 日（1–31）
- 月（1–12 或 JAN–DEC）
- 周几（1–7 或 SUN–SAT）
- （可选）年份（1970–2099）
示例：“0 0 10 * * ?” 表示每天上午10点执行。
五、多线程支持
默认情况下，Spring Boot 的定时任务是单线程的，即多个任务会串行执行。如果你希望任务并行执行，可以自定义任务调度器：
@Configuration
@EnableScheduling
public class SchedulerConfig implements SchedulingConfigurer {@Overridepublic void configureTasks(ScheduledTaskRegistrar taskRegistrar) {ThreadPoolTaskScheduler taskScheduler = new ThreadPoolTaskScheduler();taskScheduler.setPoolSize(5); // 设置线程池大小taskScheduler.initialize();taskRegistrar.setTaskScheduler(taskScheduler);}
}
六、注意事项
- 定时任务方法不能有返回值。
- 不建议在定时任务中执行耗时过长的操作，以免影响其他任务的执行。
- 如果部署在分布式环境下，需要考虑使用 Quartz 或 XXL-JOB 等分布式任务调度框架。
七、总结
Spring Boot 提供了非常简单易用的方式来实现定时任务功能。通过 @Scheduled 注解和 @EnableScheduling 启用定时任务，开发者可以快速构建定时任务逻辑。结合cron表达式和线程池配置，可以满足大多数业务场景的需求。此外，如需更复杂的任务调度（如分布式环境下的任务协调），建议使用 Quartz 或 Spring Cloud Alibaba 的 XXL-JOB 等专业任务调度平台。