Spring 定时任务@Scheduled 注解四大参数用法解析
本文主要介绍了在 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 注解内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章介绍了Java设计模式之代理模式，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2022-09-09
这篇文章主要介绍了jpa EntityManager 复杂查询实例，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2021-12-12
现在大模型开发特别火,DeepSeek 因为中文理解好、反应快、还便宜,不少 Java 开发者都用它,本文整理了最常踩的 8 个坑,希望对大家有所帮助2025-12-12
Java延时任务实现方案及四大典型场景详解(适用于Spring Boot3)
在Java编程中,延时函数是一种常用的技术,用于在程序执行过程中暂停一段时间,这篇文章主要介绍了Java延时任务实现方案及四大典型场景(适用于SpringBoot3)的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下2026-05-05
这篇文章主要为大家详细介绍了java文件读写工具类，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2018-02-02
以下是对java连接mysql数据库的具体详细步骤进行了分析介绍，需要的朋友可以过来参考下2013-08-08
这篇文章主要介绍了聊聊Java中是什么方法导致的线程阻塞，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2021-02-02
MyBatis中的collection两种使用方法及效率比较
collection主要是应对表关系是一对多的情况，本文主要介绍了MyBatis中的collection两种使用方法及效率比较，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2022-06-06
MyBatis-Plus标签@TableField之fill自动填充方式
这篇文章主要介绍了MyBatis-Plus标签@TableField之fill自动填充方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2022-06-06
这篇文章主要介绍了java中字符串常见的方法及总结，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2022-12-12
最新评论