2. Spring Boot 任务调度基础：@Scheduled 注解详解、cron 表达式、fixedRate 与 fixedDelay 区别

Spring Boot 通过 @EnableScheduling 激活调度能力，再配合 @Scheduled 注解即可声明式地定义定时任务。本章深入拆解注解的三种触发模式、cron 表达式的构成规则，以及 fixedRate 与 fixedDelay 的核心差异——这些是构建可靠 DAG 调度系统的基石。

2.1 @Scheduled 注解核心参数

@Scheduled 注解定义在无参、返回 void 的 Bean 方法上。Spring 容器启动后，由 ScheduledAnnotationBeanPostProcessor 解析并注册到 TaskScheduler 线程池中。

2.2 cron 表达式详解

cron 表达式由 6 或 7 个空格分隔的字段组成，按秒、分、时、日、月、周、年（可选）顺序排列。

常用通配符含义：

• *：匹配所有值
• ?：不指定值（仅用于日/周字段，避免冲突）
• -：范围，如 10-15
• /：步长，如 0/5 表示从 0 开始每 5 单位触发
• L：最后一天（日字段为当月最后一天，周字段为周六）
• W：最近的工作日
• #：第几个星期几，如 2#1 表示第一个星期一

常见 cron 示例：

2.3 fixedRate 与 fixedDelay 核心区别

这是任务调度中最容易混淆的概念，也是 DAG 边界设计中决定任务是否允许重叠的关键参数。

2.4 三种触发模式对比图

下图直观展示 cron、fixedRate、fixedDelay 在时间轴上的触发行为差异：

2.5 代码实战：三种模式完整示例

@Component
@EnableScheduling
public class ScheduledTaskDemo {

    // 1. cron 表达式：每天 12:00 执行
    @Scheduled(cron = "0 0 12 * * ?")
    public void reportDailySummary() {
        System.out.println("[cron] 生成日报，时间：" + LocalDateTime.now());
    }

    // 2. fixedRate：每 5 秒执行一次，不考虑任务耗时
    @Scheduled(fixedRate = 5000)
    public void heartbeat() {
        System.out.println("[fixedRate] 心跳上报，时间：" + LocalDateTime.now());
        // 模拟耗时 2 秒
        try { Thread.sleep(2000); } catch (InterruptedException e) { Thread.currentThread().interrupt(); }
    }

    // 3. fixedDelay：上次执行完后等待 3 秒再执行下一次
    @Scheduled(fixedDelay = 3000, initialDelay = 5000)
    public void cleanTempFiles() {
        System.out.println("[fixedDelay] 清理临时文件，时间：" + LocalDateTime.now());
        // 模拟耗时 4 秒
        try { Thread.sleep(4000); } catch (InterruptedException e) { Thread.currentThread().interrupt(); }
    }
}

2.6 任务调度执行流程架构图

下图展示从 Spring 容器启动到任务执行的完整链路：

2.7 常见故障与排查要点