@Scheduled注解之 fixedRate 和 fixedDelay

最新推荐文章于 2025-04-18 17:53:42 发布

weixin_44594317

最新推荐文章于 2025-04-18 17:53:42 发布

阅读量2.4k

点赞数 19

文章标签： java 定时任务 Scheduled

本文链接：https://blog.youkuaiyun.com/weixin_44594317/article/details/143613688

版权

@Scheduled注解中的 fixedRate 和 fixedDelay 都是用来控制定时任务执行频率的参数。它们定义了定时任务的执行时间间隔，但实现方式和行为有所不同。让我们深入了解这两个参数的区别和适用场景。

1. `fixedRate`

fixedRate 指定了 两次任务执行之间的固定时间间隔，即使上一次任务还没有完成，下一次任务也会按照这个间隔时间开始。

行为：定时任务会在指定的时间间隔后开始执行，而不管上一次任务是否完成。如果任务执行时间较长，下一次任务会立即开始，可能会有多个任务并行执行。
单位：fixedRate 使用的是毫秒（ms）为单位。

示例：`@Scheduled(fixedRate = 5000)`

@Scheduled(fixedRate = 5000)  // 每5秒执行一次
public void fixedRateTask() {
    System.out.println("Task executed at " + LocalTime.now());
    try {
        Thread.sleep(3000);  // 模拟任务执行时间
    } catch (InterruptedException e) {
        e.printStackTrace();
    }
}

执行流程：假设第一次任务开始执行时间为 00:00:00，那么它会在 00:00:00 执行，然后下一个任务会在 00:00:05 执行（即使第一次任务未结束，第二次任务也会按时开始）。如果任务的执行时间超过了5秒，任务会并行执行。
适用场景：
- 任务执行时间较短且不需要等待上次任务完成。
- 需要确保任务固定间隔时间进行执行，通常用于定时任务、周期性统计等场景。

2. `fixedDelay`

fixedDelay 指定了 上一次任务结束和下一次任务开始之间的固定时间间隔。换句话说，它保证每次任务之间会有固定的间隔时间，无论上一次任务的执行时间多长，都会等待上一次任务完成后再开始下一次。

行为：定时任务会等待上一次任务完成，并且在上次任务结束后，按指定的间隔时间启动下一次任务。任务之间是按顺序执行的，不会并行执行。
单位：fixedDelay 也是以毫秒（ms）为单位。

示例：`@Scheduled(fixedDelay = 5000)`

@Scheduled(fixedDelay = 5000)  // 每次任务结束后5秒执行一次
public void fixedDelayTask() {
    System.out.println("Task executed at " + LocalTime.now());
    try {
        Thread.sleep(3000);  // 模拟任务执行时间
    } catch (InterruptedException e) {
        e.printStackTrace();
    }
}

执行流程：假设第一次任务开始执行时间为 00:00:00，任务结束时间为 00:00:03，那么下一个任务会在 00:00:08 执行。即，第二次任务会等第一次任务完全结束后，延迟5秒再执行。
适用场景：
- 任务的执行时间较长，且需要确保任务之间有间隔时间。
- 任务必须按顺序执行，适合有依赖关系的任务。

3. 区别总结

参数	解释	执行行为	适用场景
fixedRate	两次任务执行之间的固定时间间隔	不管上一次任务是否结束，下一次任务按照固定间隔时间执行	适合周期性执行的任务，任务执行时间短，或并行任务
fixedDelay	上一次任务结束后，下一次任务开始的固定时间间隔	等待上一次任务结束后，按指定延迟时间再执行下一次任务	适合任务执行时间较长，且任务之间需要间隔时间

4. `initialDelay` 参数

@Scheduled 还支持一个额外的参数 initialDelay，它表示 第一次任务执行前的延迟时间。这通常用于在应用启动后，延迟一段时间再开始第一次任务。

示例：`@Scheduled(fixedRate = 5000, initialDelay = 10000)`

@Scheduled(fixedRate = 5000, initialDelay = 10000)
public void fixedRateWithInitialDelay() {
    System.out.println("Task executed at " + LocalTime.now());
}