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

@scheduled 注解是 spring 提供的一个注解式定时任务调度工具，用于简化定时任务的实现。它的默认行为是单线程执行，即任务默认在同一个线程中依次执行。如果任务抛出异常或执行时间过长，可能会影响后续任务的调度。

在 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