SpringBoot使用@Scheduled定时器的示例详解

更新时间：2025年07月29日 10:29:36 作者：FlyLikeButterfly

SpringBoot的@Scheduled注解用于配置定时任务,需启用@EnableScheduling,支持fixedRate、fixedDelay、cron等参数,控制执行频率、延迟及周期,支持线程池和异常处理配置,默认单线程串行执行,本文介绍SpringBoot使用@Scheduled定时器的操作示例,感兴趣的朋友一起看看吧

使用方法：

先启用定时器配置，添加注解@EnableScheduling，可在@SpringBootApplication或者@Configuration或者@Component等spring能够扫描到的地方；
在spring能够识别的类中定义没有返回值和参数的方法，在方法上使用@Scheduled注解；

@Scheduled注解的参数解释：

fixedRate：固定速率（ms），按照每次任务的开始时间间隔执行（定时器启动的时候每次开始时间就已确定），上一次任务执行时间超过后面的任务开始时间，后面任务会积压到队列里，等这个时间很长的任务结束后，队列里的积压任务全部同时放行；
fixedRateString：同上，字符串类型，支持${}占位符，可灵活配置；
fixedDelay：固定延迟（ms），以上次的结束时间开始延迟一定时间执行下一次，不会积压；
fixedDelayString：同上，字符串类型，支持${}占位符，可灵活配置；
initialDelay：延迟启动定时器时间（ms），指定一段时间后才开始启动定时器；
initialDelayString：同上，字符串类型，支持${}占位符，可灵活配置；
cron：cron表达式，比上面的更灵活，字符串类型，支持${}占位符，上次任务如果超时会自动丢弃当前时间应该执行的任务；（跟linux的cron稍有区别，linux的是“分时日月周”，这个是“秒分时日月周[年]”，多了秒和可省略的年）
zone：时区，一般默认即可，自动使用服务器时区，也可指定如“Asia/Shanghai”；

PS：占位符可以只占String的一部分；定时器里如果抛出异常不会影响下一次任务；对cron的简单理解，可以把每个字段的设置都解释为一个整数数组，例如在秒字段上的0/10，可以解释成[0, 10, 20, 30, 40, 50]，在月字段上的*表示所有值，可解释成[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]，也就是每个月都有；

测试代码：

启动类：

package testspringschedule;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableScheduling;
@SpringBootApplication
@EnableScheduling
public class TestSpringSchedule {
	public static void main(String[] args) {
		System.out.println("main start");
		SpringApplication.run(TestSpringSchedule.class, args);
	}
}

测试fixedRate：

package testspringschedule;
import java.util.Date;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
//@Configuration
@Component
//@EnableScheduling
public class MyRateSchedule {
	@Scheduled(fixedRate = 5000, initialDelay = 3000, zone = "Asia/Shanghai")
//	@Scheduled(fixedRateString = "5000", initialDelayString = "3000")
//	@Scheduled(fixedRateString = "${abc:5}000", initialDelayString = "${def:3000}")
	public void test1() {
		System.out.println("fixedRate start:" + new Date());
		try {
			Thread.sleep(1000);
		} catch (InterruptedException e) {
			e.printStackTrace();
		}
		System.out.println("fixedRate stop:" + new Date());
	}
	private int i = 0;
//	@Scheduled(fixedRate = 1000, initialDelay = 3000)
	public void test2() {
		System.out.println("fixedRate start:" + new Date());
		i++;
		System.out.println(i);
		if (i == 5) {
			try {
				Thread.sleep(5000);
			} catch (InterruptedException e) {
				e.printStackTrace();
			}
		}
		System.out.println("fixedRate stop:" + new Date());
	}
}

test1()执行结果，开始时间都是间隔5s：

test2()执行结果，开始时间间隔1s，超时积压多个任务等上一个任务结束后全部同时执行；

测试fixedDelay：

package testspringschedule;
import java.util.Date;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@Component
public class MyDelaySchedule {
	@Scheduled(fixedDelay = 5000, initialDelay = 3000)
	public void test1() {
		System.out.println("fixedDelay start:" + new Date());
		try {
			Thread.sleep(3000);
		} catch (InterruptedException e) {
			e.printStackTrace();
		}
		System.out.println("fixedDelay stop:" + new Date());
	}
}

执行结果：

测试cron：

package testspringschedule;
import java.util.Date;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@Component
public class MyCronSchedule {
	@Scheduled(cron = "50/2 * * * * ?")
//	@Scheduled(cron = "${s:1/2 * * * * ?}")
//	@Scheduled(cron = "${s:0/5} * * * * ?")
	public void test1() {
		System.out.println("cron:" + new Date());
	}
//	@Scheduled(cron = "0/10 * * * * ?")
	public void test2() {
		System.out.println("cron start:" + new Date());
		try {
			Thread.sleep(11000);
		} catch (InterruptedException e) {
			e.printStackTrace();
		}
		System.out.println("cron stop:" + new Date());
	}
}

test1()执行结果：

test2()执行结果，超时丢弃：

也可以实现SchedulingConfigurer接口，使用配置类进行线程池、异常处理、拒绝策略等的一些配置：（默认配置所有定时器都是单线程串行的）

package testspringschedule;
import java.util.concurrent.ThreadPoolExecutor;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.SchedulingConfigurer;
import org.springframework.scheduling.concurrent.ThreadPoolTaskScheduler;
import org.springframework.scheduling.config.ScheduledTaskRegistrar;
import org.springframework.util.ErrorHandler;
@Configuration
public class MyScheduleConfig implements SchedulingConfigurer {
	@Override
	public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
		final ThreadPoolTaskScheduler taskScheduler = new ThreadPoolTaskScheduler();
        taskScheduler.setPoolSize(50);
        taskScheduler.setThreadGroupName("Scheduled-Group");
        taskScheduler.setRejectedExecutionHandler(new ThreadPoolExecutor.DiscardPolicy());
        taskScheduler.setErrorHandler(new ErrorHandler() {
			@Override
			public void handleError(Throwable t) {
				System.out.println("发生未捕获异常:");
				t.printStackTrace();
			}
		});
        taskScheduler.initialize();
        taskRegistrar.setTaskScheduler(taskScheduler);
	}
}

到此这篇关于SpringBoot使用@Scheduled定时器的文章就介绍到这了,更多相关SpringBoot @Scheduled定时器内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Plugin ‘org.springframework.boot:spring-boot-maven-plug
这篇文章给大家介绍了Plugin ‘org.springframework.boot:spring-boot-maven-plugin:‘ not found的解决方案,亲测可用,文中给出了两种解决方法,需要的朋友可以参考下
2024-01-01
springboot加载一个properties文件转换为map方式
这篇文章主要介绍了springboot加载一个properties文件转换为map方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-07-07
Spring Boot 2.x 实现文件上传功能
这篇文章主要介绍了Spring Boot 2.x 实现文件上传功能,本文分步骤通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2021-01-01
idea使用外置tomcat配置springboot详细步骤
昨天小编遇到一个问题使用springboot自带的tomcat启动没有任何问题，不知道idea使用外置tomcat配置springboot该如何设置的，今天小编给大家分享一篇教程帮助大家解决这个问题
2021-07-07
详解spring Boot 集成 Thymeleaf模板引擎实例
本篇文章主要介绍了spring Boot 集成 Thymeleaf模板引擎实例，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2017-09-09
Spring使用@Retryable实现自动重试机制
在微服务架构中,服务之间的调用可能会因为一些暂时性的错误而失败,例如网络波动、数据库连接超时或第三方服务不可用等,在本文中,我们将介绍如何在 Spring 中使用 @Retryable 实现自动重试机制,需要的朋友可以参考下
2025-01-01
java连接mysql数据库详细步骤解析
以下是对java连接mysql数据库的具体详细步骤进行了分析介绍，需要的朋友可以过来参考下
2013-08-08
Java8 Comparator: 列表排序的深入讲解
这篇文章主要给大家介绍了关于Java 8 Comparator: 列表排序的相关资料，文中通过示例代码介绍的非常详细，对大家学习或者使用Java8具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-05-05
如何实现在IDEA中导入一个模块
这篇文章主要介绍了如何实现在IDEA中导入一个模块方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-04-04
值得收藏的SpringBoot 实用的小技巧
最近分享的一些源码、框架设计的东西。我发现大家热情不是特别高，想想大多数应该还是正儿八经写代码的居多；这次就分享一点接地气的： SpringBoot 使用中的一些小技巧 ,需要的朋友可以参考下
2018-10-10