spring@Scheduled定时任务注解使用方法及注意事项小结，

来源： javaer 分享于 2025-02-26 点击 37715 次点评：22

spring@Scheduled定时任务注解使用方法及注意事项小结，

默认行为

单线程执行：Spring 的 @Scheduled 注解默认使用单线程调度器（SimpleScheduledExecutor），因此多个任务会串行执行。
任务阻塞：如果一个任务执行时间过长，会阻塞后续任务的执行。

如何实现并行执行

如果需要多个定时任务并行执行，可以通过以下方法实现：

方法 1：配置多线程调度器

可以通过配置 ThreadPoolTaskScheduler 来为 @Scheduled 任务提供一个线程池，从而允许多个任务并行执行。

示例代码：

@Configuration
public class ScheduleConfig {
    @Bean
    public ThreadPoolTaskScheduler taskScheduler() {
        ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
        scheduler.setPoolSize(5); // 设置线程池大小
        scheduler.setThreadNamePrefix("my-scheduled-task-");
        return scheduler;
    }
}

在 @Scheduled 注解中指定使用自定义调度器：

@Scheduled(fixedRate = 5000, scheduler = "taskScheduler")
public void task1() {
    // 任务内容
}

方法 2：使用 @Async注解

可以通过结合 @Async 注解和 @EnableAsync 注解，使每个 @Scheduled 任务在独立的线程中异步执行。

示例代码：

@Configuration
@EnableAsync
public class AsyncConfig {
    @Bean
    public TaskScheduler taskScheduler() {
        ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
        scheduler.setPoolSize(5); // 设置线程池大小
        return scheduler;
    }
}

在任务方法上添加 @Async 注解：

@Async
@Scheduled(fixedRate = 5000)
public void task1() {
    // 任务内容
}

方法 3：通过配置文件设置线程池大小

在 Spring Boot 中，可以通过配置文件直接设置 spring.task.scheduling.pool.size 属性来增加线程池大小。

示例配置：

spring.task.scheduling.pool.size=5

总结

默认行为：@Scheduled 注解默认是单线程依次执行。
并行执行：可以通过配置多线程调度器或使用 @Async 注解实现并行执行。
推荐方式：配置多线程调度器（ThreadPoolTaskScheduler）是最常用的方式，适合大多数场景。

通过以上方法，可以轻松实现多个定时任务的并行执行！

以下是 @Scheduled 注解的参数大全及其详细说明：

1. cron

含义：指定一个 cron 表达式，用于定义任务的执行时间。
格式：cron 表达式由 6 或 7 个字段组成，分别表示秒、分、小时、日、月、星期（和年）。
示例：
- 每隔 5 秒执行一次：0/5 * * * * *
- 每天 23 点执行一次：0 0 23 * * *
- 每月 1 号凌晨 1 点执行一次：0 0 1 1 * *

2. zone

含义：指定时区，用于解析 cron 表达式。
类型：String，默认值为空字符串，表示使用服务器的默认时区。
示例：Asia/Shanghai

3. fixedRate

含义：指定任务以固定的时间间隔执行，单位为毫秒。
类型：long，默认值为 -1，表示不使用固定速率。
示例：@Scheduled(fixedRate = 5000) 表示每隔 5 秒执行一次

4. fixedRateString

含义：与 fixedRate 类似，但使用字符串类型，支持占位符。
类型：String，默认值为空字符串。
示例：@Scheduled(fixedRateString = "5000") 表示每隔 5 秒执行一次

5. fixedDelay

含义：指定任务在上一次执行结束后，经过固定的时间间隔再执行下一次，单位为毫秒。
类型：long，默认值为 -1，表示不使用固定延迟。
示例：@Scheduled(fixedDelay = 5000) 表示上一次任务执行结束后，等待 5 秒再执行下一次

6. fixedDelayString

含义：与 fixedDelay 类似，但使用字符串类型，支持占位符。

类型：String，默认值为空字符串。

示例：@Scheduled(fixedDelayString = "5000") 表示上一次任务执行结束后，等待 5 秒再执行下一次

7. initialDelay

含义：指定任务首次执行前的延迟时间，单位为毫秒。
类型：long，默认值为 -1，表示不使用初始延迟。
示例：@Scheduled(initialDelay = 5000, fixedRate = 10000) 表示首次延迟 5 秒后执行，之后每隔 10 秒执行一次

8. initialDelayString

含义：与 initialDelay 类似，但使用字符串类型，支持占位符。
类型：String，默认值为空字符串。
示例：@Scheduled(initialDelayString = "5000", fixedRateString = "10000") 表示首次延迟 5 秒后执行，之后每隔 10 秒执行一次

9. CRON_DISABLED

含义：一个特殊的 cron 表达式值，用于禁用定时任务。
值："-"，当 cron 表达式设置为 "-" 时，任务将被禁用

总结

cron：适合复杂的定时任务调度，如按特定时间点执行。
fixedRate 和 fixedDelay：适合简单的定时任务调度，如每隔固定时间执行。
initialDelay：用于控制任务的首次执行时间。
zone：用于指定时区，确保任务按正确的时区执行。

通过合理使用这些参数，可以灵活地配置定时任务的执行计划，满足各种业务需求。

到此这篇关于spring @Scheduled定时任务注解使用方法以及注意事项的文章就介绍到这了,更多相关spring @Scheduled定时任务注解内容请搜索3672js教程以前的文章或继续浏览下面的相关文章希望大家以后多多支持3672js教程！

您可能感兴趣的文章:

Spring自带定时任务@Scheduled注解实例讲解
Spring定时任务@scheduled多线程使用@Async注解示例
Spring定时任务@Scheduled注解(cron表达式fixedRate fixedDelay)
Spring中的@Scheduled定时任务注解详解
SpringBoot中@Scheduled()注解以及cron表达式详解
Spring 定时任务@Scheduled 注解中的 Cron 表达式详解
SpringBoot中定时任务@Scheduled注解的使用解读
spring-boot通过@Scheduled配置定时任务及定时任务@Scheduled注解的方法
详解在Spring3中使用注解(@Scheduled)创建计划任务

spring@Scheduled定时任务注解使用方法及注意事项小结，