Spring 定时任务@Scheduled 注解四大参数用法解析

更新时间：2025年01月24日 09:53:27 作者：Yeats_Liao

本文详细介绍了Spring框架中使用@Scheduled注解实现定时任务的方法,重点讲解了fixedRate、fixedDelay、cron和initialDelay这四个参数的用法,并通过实例代码进行了详细说明,感兴趣的朋友一起看看吧

1. fixedRate 参数

参数含义

fixedRate指定任务固定时间间隔执行。如设为 3000 毫秒（3 秒），第一次任务启动后，后续任务每隔 3 秒尝试启动，不考虑前次任务是否完成。

示例代码

创建一个简单的 Spring Boot 项目，并在主类上添加@SpringBootApplication注解以启用 Spring Boot 自动配置。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableScheduling;
@SpringBootApplication
@EnableScheduling // 启用定时任务功能
public class ScheduledDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(ScheduledDemoApplication.class, args);
    }
}

创建一个定时任务类，doTask方法被@Scheduled注解修饰，fixedRate设置为 3000 毫秒。在方法内部，我们首先打印出执行次数和当前时间，然后通过Thread.sleep模拟任务执行耗时 5 秒。运行应用程序后，你会发现尽管任务执行时间超过了 3 秒，但每隔 3 秒就会有一次新的任务尝试启动，导致任务会重叠执行。

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@Component
public class FixedRateTask {
    private int count = 0;
    @Scheduled(fixedRate = 3000)
    public void doTask() {
        System.out.println("FixedRateTask - 执行次数: " + (++count) + "，当前时间: " + System.currentTimeMillis());
        try {
            // 模拟任务执行耗时 5 秒
            Thread.sleep(5000);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }
}

2. fixedDelay 参数

参数含义

与fixedRate不同，fixedDelay参数关注的是上一次任务执行完成后的延迟时间。也就是说，只有当上一次任务彻底结束后，才会开始计算固定的延迟时间，之后才启动下一次任务。例如，设置fixedDelay = 3000毫秒，那么在上一次任务完成后，会等待 3 秒才开始下一次任务。

示例代码

创建一个FixedDelayTask类，doTask方法的fixedDelay设置为 3000 毫秒，任务模拟执行耗时 2 秒。运行后可以看到，每次任务执行完成后，会等待 3 秒才开始下一次任务，任务不会重叠执行。

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@Component
public class FixedDelayTask {
    private int count = 0;
    @Scheduled(fixedDelay = 3000)
    public void doTask() {
        System.out.println("FixedDelayTask - 执行次数: " + (++count) + "，当前时间: " + System.currentTimeMillis());
        try {
            // 模拟任务执行耗时 2 秒
            Thread.sleep(2000);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }
}

3. cron 参数

参数含义

cron参数提供了一种高度灵活的定时任务执行时间设置方式。它基于 cron 表达式，该表达式由 6 个或 7 个字段组成，分别对应秒、分钟、小时、日、月、星期（星期可以用数字 0 - 6 表示，其中 0 或 7 代表星期日）以及可选的年。通过合理组合这些字段的值，可以精确地定义任务在何时执行。

示例代码

创建一个CronTask类，cron表达式"0 0/5 * * * *"表示每隔 5 分钟执行一次任务。例如，任务可能在 10:00:00、10:05:00、10:10:00 等时间点执行。：

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@Component
public class CronTask {
    @Scheduled(cron = "0 0/5 * * * *")
    public void doTask() {
        System.out.println("CronTask - 执行时间: " + System.currentTimeMillis());
    }
}

4. initialDelay 参数

参数含义

initialDelay参数用于指定定时任务在应用启动后首次执行的延迟时间。它可以与fixedRate、fixedDelay或cron等参数结合使用，以便在应用启动后等待一段时间再开始执行定时任务。

示例代码

创建一个InitialDelayTask类，、fixedRate设置为 3000 毫秒，initialDelay设置为 5000 毫秒。这意味着应用启动后，会先等待 5 秒，然后才开始按照每 3 秒的固定间隔执行任务。

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@Component
public class InitialDelayTask {
    private int count = 0;
    @Scheduled(fixedRate = 3000, initialDelay = 5000)
    public void doTask() {
        System.out.println("InitialDelayTask - 执行次数: " + (++count) + "，当前时间: " + System.currentTimeMillis());
    }
}

5. 总结

对于一些对实时性要求较高且执行时间较短的任务，可以考虑使用fixedRate；
对于执行时间较长且不希望任务重叠的任务，fixedDelay可能更为合适；
对于需要在特定时间点或按照复杂时间规则执行的任务，cron表达式则是不二之选。
initialDelay参数可以帮助我们更好地控制任务的启动时间，避免在应用启动初期因大量任务同时启动而带来的性能压力。

到此这篇关于Spring 定时任务@Scheduled 注解四大参数解析的文章就介绍到这了,更多相关Spring 定时任务@Scheduled 注解内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

SpringMVC请求乱码处理的2种方式
这篇文章主要介绍了SpringMVC请求乱码处理的2种方式,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-11-11
SpringCloud中NacosNamingService的作用详解
这篇文章主要介绍了SpringCloud中NacosNamingService的作用详解,NacosNamingService类完成服务实例注册,撤销与获取服务实例操作,NacosNamingService初始化采用单例模式,使用反射生成,需要的朋友可以参考下
2023-11-11
Java指令重排引发问题及解决方案
指令重排是JVM在解释执行Java代码时对指令顺序进行重新排列的一种优化技术,本文主要介绍了Java指令重排引发问题及解决方案,感兴趣的可以了解一下
2023-08-08
Java BigDecimal正确用法详解
Java在java.math包中提供的API类BigDecimal，用来对超过16位有效位的数进行精确的运算。双精度浮点型变量double可以处理16位有效数，但在实际应用中，可能需要对更大或者更小的数进行运算和处理
2022-10-10
简单分析Java的求值策略原理
在本篇文章里小编给大家整理的是一篇关于简单分析Java的求值策略原理内容，有需要的朋友们可以学习下。
2021-06-06
详解Spring @Autowired 注入小技巧
这篇文章主要介绍了详解Spring @Autowired 注入小技巧,小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-07-07
分布式难题ElasticSearch解决大数据量检索面试
这篇文章主要为大家介绍了分布式面试难题，ElasticSearch解决大数据量检索的问题分析回答，让面试官无话可说，帮助大家实现面试开薪自由
2022-03-03
java分布式流式处理组件Producer分区理论
这篇文章主要为大家介绍了java分布式流式处理组件Producer分区理论详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-03-03
Java中Thread.join()的使用方法
这篇文章主要介绍了Java中Thread.join()的使用方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-07-07
关于Spring配置文件加载方式变化引发的异常详解
这篇文章主要给大家介绍了关于Spring配置文件加载方式变化引发的异常的相关资料,文中通过实例代码介绍的非常详细,对大家学习或者使用Spring具有一定的参考学习价值,需要的朋友可以参考下
2022-01-01