@Scheduled注解的使用之SpringBoot-Springtask介绍
更新时间：2026年04月02日 08:36:15 作者：需要重新演唱
@Scheduled注解用于Spring定时任务调度,支持固定速率、固定延迟、cron表达式等多种执行规则,通过配置方法参数和属性,灵活定义任务执行时间,适用于自动化、定时作业场景,需注意异常处理和任务稳定性
@Scheduled 注解是 Spring 框架中用于定时任务调度的核心注解之一。通过 @Scheduled 注解，开发者可以非常方便地在 Spring 应用程序中定义和配置各种定时任务，包括固定速率执行、固定延迟执行、cron 表达式执行等。
本文将详细讲解 @Scheduled 注解的各个方面，包括其属性、使用方法、配置方式以及一些最佳实践。
基本概念
@Scheduled 注解用于标记一个方法，使其成为一个定时任务，按照指定的时间规则自动执行。被 @Scheduled 注解标记的方法必须是 void 返回类型，并且不能接受任何参数。
属性详解
@Scheduled 注解提供了多个属性，用于定义任务的执行规则：
fixedRate：
- 类型：
long - 描述：以毫秒为单位，定义任务两次执行之间的固定时间间隔。任务会以固定的时间间隔执行，即使前一次任务的执行时间超过了这个间隔。
- 示例：
@Scheduled(fixedRate = 5000)表示任务每 5 秒执行一次。
fixedDelay：
- 类型：
long - 描述：以毫秒为单位，定义任务两次执行之间的固定延迟时间。任务会在前一次执行完成后，等待指定的延迟时间后再执行下一次。
- 示例：
@Scheduled(fixedDelay = 5000)表示任务在前一次执行完成后，等待 5 秒再执行下一次。
initialDelay：
- 类型：
long - 描述：以毫秒为单位，定义任务首次执行前的初始延迟时间。任务会在应用程序启动后，等待指定的初始延迟时间后再首次执行。
- 示例：
@Scheduled(fixedRate = 5000, initialDelay = 1000)表示任务在应用程序启动后等待 1 秒，然后每 5 秒执行一次。
cron：
- 类型：
String - 描述：使用 cron 表达式定义任务的执行时间规则。cron 表达式非常灵活，可以定义复杂的执行时间规则。
- 示例：
@Scheduled(cron = "0 0 12 * * ?")表示任务每天中午 12 点执行。
zone：
- 类型：
String - 描述：定义 cron 表达式使用的时区。默认情况下，使用服务器的本地时区。
- 示例：
@Scheduled(cron = "0 0 12 * * ?", zone = "GMT")表示任务每天中午 12 点在 GMT 时区执行。
使用方法
要使用 @Scheduled 注解，首先需要在 Spring 配置类上启用任务调度功能，可以通过 @EnableScheduling 注解来实现：
@Configuration
@EnableScheduling
public class SchedulingConfig {
}
然后，在需要定时执行的方法上添加 @Scheduled 注解，并配置相应的属性：
@Component
public class ScheduledTasks {
private static final Logger logger = LoggerFactory.getLogger(ScheduledTasks.class);
@Scheduled(fixedRate = 5000)
public void runTaskAtFixedRate() {
logger.info("Fixed rate task - {}", System.currentTimeMillis());
}
@Scheduled(fixedDelay = 5000)
public void runTaskAtFixedDelay() {
logger.info("Fixed delay task - {}", System.currentTimeMillis());
}
@Scheduled(initialDelay = 1000, fixedRate = 5000)
public void runTaskWithInitialDelay() {
logger.info("Task with initial delay - {}", System.currentTimeMillis());
}
@Scheduled(cron = "0 0 12 * * ?")
public void runTaskAtNoon() {
logger.info("Noon task - {}", System.currentTimeMillis());
}
}
配置方式
除了在方法上直接使用 @Scheduled 注解外，还可以通过配置文件（如 XML 或 properties 文件）来定义定时任务的执行规则。这种方式适用于需要动态配置任务执行规则的场景。
XML 配置
在 Spring 的 XML 配置文件中，可以通过 <task:scheduled-tasks> 标签来配置定时任务：
<task:scheduled-tasks scheduler="scheduler">
<task:scheduled ref="scheduledTasks" method="runTaskAtFixedRate" fixed-rate="5000"/>
<task:scheduled ref="scheduledTasks" method="runTaskAtFixedDelay" fixed-delay="5000"/>
<task:scheduled ref="scheduledTasks" method="runTaskWithInitialDelay" initial-delay="1000" fixed-rate="5000"/>
<task:scheduled ref="scheduledTasks" method="runTaskAtNoon" cron="0 0 12 * * ?"/>
</task:scheduled-tasks>
<task:scheduler id="scheduler" pool-size="10"/>
Properties 配置
在 Spring Boot 应用程序中，可以通过 application.properties 文件来配置定时任务的执行规则：
# 定义定时任务的执行规则 scheduled.task.fixedRate=5000 scheduled.task.fixedDelay=5000 scheduled.task.initialDelay=1000 scheduled.task.cron=0 0 12 * * ?
然后在代码中使用 @Value 注解来读取这些配置：
@Component
public class ScheduledTasks {
private static final Logger logger = LoggerFactory.getLogger(ScheduledTasks.class);
@Value("${scheduled.task.fixedRate}")
private long fixedRate;
@Value("${scheduled.task.fixedDelay}")
private long fixedDelay;
@Value("${scheduled.task.initialDelay}")
private long initialDelay;
@Value("${scheduled.task.cron}")
private String cron;
@Scheduled(fixedRateString = "${scheduled.task.fixedRate}")
public void runTaskAtFixedRate() {
logger.info("Fixed rate task - {}", System.currentTimeMillis());
}
@Scheduled(fixedDelayString = "${scheduled.task.fixedDelay}")
public void runTaskAtFixedDelay() {
logger.info("Fixed delay task - {}", System.currentTimeMillis());
}
@Scheduled(initialDelayString = "${scheduled.task.initialDelay}", fixedRateString = "${scheduled.task.fixedRate}")
public void runTaskWithInitialDelay() {
logger.info("Task with initial delay - {}", System.currentTimeMillis());
}
@Scheduled(cron = "${scheduled.task.cron}")
public void runTaskAtNoon() {
logger.info("Noon task - {}", System.currentTimeMillis());
}
}
最佳实践
在使用 @Scheduled 注解时，以下是一些最佳实践：
- 合理选择执行规则：根据任务的性质和需求，合理选择
fixedRate、fixedDelay或cron表达式来定义任务的执行规则。 - 避免长时间任务：尽量避免在定时任务中执行长时间运行的操作，以免影响其他任务的执行。
- 异常处理：在定时任务中添加适当的异常处理逻辑，以避免任务执行失败导致系统不稳定。
- 监控和日志：对定时任务的执行情况进行监控和日志记录，以便及时发现和解决问题。
- 动态配置：对于需要动态调整执行规则的任务，可以通过配置文件或外部系统来实现动态配置。
总结
@Scheduled 注解是 Spring 框架中非常强大且易用的定时任务调度工具。通过合理配置和使用 @Scheduled 注解，开发者可以方便地实现各种定时任务，提高应用程序的自动化和响应能力。在使用过程中，应遵循最佳实践，确保任务的稳定执行和系统的可靠性。
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。
相关文章
这篇文章主要介绍了Java中动态地改变数组长度及数组转map的代码分享,其中转Map利用到了java.util.Map接口,需要的朋友可以参考下2016-03-03
这篇文章主要介绍了Java实现提取不重复的整数实例，具有一定借鉴价值,需要的朋友可以参考下2017-12-12
基于Java字符串 "==" 与 "equals" 的深入理解
本篇文章是对Java中的字符串"=="与"equals"进行了详细的分析介绍，需要的朋友参考下2013-06-06
本篇文章主要介绍了Java四种线程池的使用详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2017-08-08
这篇文章主要给大家介绍了关于Java求字符串长度的相关资料,Java中的字符串是一种常见的数据类型,用于表示文本数据,文中给出了详细的代码实例,需要的朋友可以参考下2023-10-10
logback的FileAppender文件追加模式和冲突检测解读
这篇文章主要为大家介绍了logback的FileAppender文件追加模式和冲突检测解读,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪2023-10-10
下面小编就为大家分享一篇java将数据写入内存,磁盘的方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2018-01-01
本文主要介绍了Java 敏感信息加密处理的相关知识：1）敏感信息加密处理我们要实现什么；2）敏感信息加密处理我做了些什么；3）敏感信息加密实现方法。具有很好的参考价值，下面跟着小编一起来看下吧2017-03-03
详解为什么阿里巴巴禁止使用BigDecimal的equals方法做等值比较
这篇文章主要介绍了详解为什么阿里巴巴禁止使用BigDecimal的equals方法做等值比较，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-09-09
本文重点介绍我在Spring Boot 与 Vue.js 整合实践过程中的基本流程，以及遇到的问题，感兴趣的朋友跟随小编一起看看吧2018-09-09
最新评论