💡 前言

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

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

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

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

📦 一、Spring Boot 定时任务简介

✅ 什么是定时任务？

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

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

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

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

常用示例：

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

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

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

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

Step 2：启用定时任务功能

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

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

Step 3：编写定时任务方法

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

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

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

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

自定义线程池配置类：

@Configuration
public class SchedulerConfig implements SchedulingConfigurer {

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

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

🎯 五、实战案例解析

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

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

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

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

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

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

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

📘 七、总结对比表

🎁 八、结语

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

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

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