Spring Boot 定时任务全攻略：从入门到实战，一篇文章讲清楚！

💡 前言

在实际开发中，我们经常会遇到需要定时执行的任务场景，例如：

每天凌晨清理日志
每小时同步数据
每分钟检查订单状态
发送邮件、短信提醒等

Spring Boot 提供了非常便捷的定时任务支持 ------ @Scheduled 注解，让我们可以轻松实现定时功能。

本文将带你从基础概念讲起，手把手教你掌握 Spring Boot 中定时任务的使用方式，并通过多个实用示例帮助你快速上手，适用于企业级项目开发。

📦 一、Spring Boot 定时任务简介

✅ 什么是定时任务？

定时任务是指在特定的时间点或周期性地执行某段代码逻辑。Spring Boot 使用的是基于 TaskScheduler 的调度机制，默认使用 单线程 执行任务。

✅ 支持的定时表达式（cron）

Spring Boot 支持标准的 cron 表达式来定义任务执行频率：

txt 复制代码

秒 分 时 日 月 星期 年（可选）

常用示例：

表达式	含义
`0 0 1 * * ?`	每天凌晨1点执行
`0/5 * * * * ?`	每隔5秒执行一次
`0 0/30 9-17 * * ?`	工作日上午每隔半小时执行一次
`0 0 12 ? * SUN`	每周日中午12点执行

🧪 二、启用定时任务的步骤

Step 1：添加依赖（默认已包含）

Spring Boot 默认已经集成了定时任务功能，无需额外引入依赖。

xml 复制代码

<!-- 如果是 Web 项目，通常已有以下依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
</dependency>

Step 2：启用定时任务功能

在启动类或配置类上添加 @EnableScheduling 注解：

java 复制代码

@SpringBootApplication
@EnableScheduling
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

Step 3：编写定时任务方法

创建一个组件类（如 ScheduledTasks.java），并在方法上使用 @Scheduled 注解定义执行策略：

java 复制代码

@Component
public class ScheduledTasks {

    @Scheduled(fixedRate = 5000)
    public void runEveryFiveSeconds() {
        System.out.println("【定时任务】每5秒执行一次：" + new Date());
    }

    @Scheduled(cron = "0 0 0 * * ?") // 每天0点执行
    public void dailyCleanUp() {
        System.out.println("【定时任务】开始每日清理操作：" + new Date());
    }
}

🧭 三、@Scheduled 注解详解

属性	描述	示例
`fixedRate`	固定频率（毫秒）执行，无论上次是否执行完	`fixedRate = 5000`（每5秒）
`fixedDelay`	上次执行完成后延迟固定时间再执行下一次	`fixedDelay = 5000`
`initialDelay`	初始延迟时间（需配合 fixedRate/fixedDelay 使用）	`initialDelay = 10000`
`cron`	使用 cron 表达式定义执行时间	`cron = "0 0 1 * * ?"`

📌 注意：

fixedRate 和 fixedDelay 是互斥的，不能同时设置。
@Scheduled 方法必须为无参、void 返回值。
默认情况下，所有任务都在同一个线程中顺序执行。

🧠 四、多线程执行定时任务（提升并发性能）

如果希望定时任务并发执行而不是串行执行，可以自定义任务调度器：

自定义线程池配置类：

java 复制代码

@Configuration
public class SchedulerConfig implements SchedulingConfigurer {

    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        // 设置线程池大小为5
        taskRegistrar.setScheduler(Executors.newScheduledThreadPool(5));	
    }
}

这样就可以让多个定时任务并行执行，提高系统吞吐量。

🎯 五、实战案例解析

✅ 案例一：每天凌晨清理日志文件

java 复制代码

@Scheduled(cron = "0 0 0 * * ?")
public void cleanLogs() {
    log.info("开始清理日志文件...");
    // 调用删除逻辑，比如删除30天前的日志文件
}

✅ 案例二：每小时同步远程数据

java 复制代码

@Scheduled(fixedRate = 60 * 60 * 1000)
public void syncData() {
    log.info("开始同步远程数据...");
    // 调用外部接口获取数据并保存
}

✅ 案例三：每分钟检查超时订单

java 复制代码

@Scheduled(fixedRate = 60 * 1000)
public void checkTimeoutOrders() {
    List<Order> orders = orderService.findTimeoutOrders();
    for (Order order : orders) {
        order.setStatus("CANCELLED");
        orderService.update(order);
    }
}

🔐 六、注意事项与最佳实践

问题	解决方案
多实例部署下重复执行	结合分布式锁（如 Redis 锁）控制只有一台机器执行
任务异常导致中断	使用 try-catch 包裹任务逻辑，记录日志
任务未执行	查看是否遗漏 `@EnableScheduling` 注解
时间不准确	注意服务器时间与时区设置一致
任务耗时过长	使用异步调用或拆分任务逻辑

📘 七、总结对比表

功能	描述
启用方式	`@EnableScheduling`
核心注解	`@Scheduled`
支持类型	fixedRate / fixedDelay / initialDelay / cron
线程模型	单线程（默认）或自定义线程池
适用场景	数据清理、同步、监控、定时通知等
高可用建议	结合 Redis 分布式锁避免重复执行

🎁 八、结语

Spring Boot 的定时任务模块虽然简单，但非常实用。无论是小型项目还是大型分布式系统，都可以借助它完成各种定时触发的业务逻辑。

掌握它的基本用法和高级技巧，不仅能让你写出更健壮的后端服务，也能在面试中加分不少。

🎯如果你觉得有用，欢迎点赞、收藏、转发给更多需要的朋友！