SpringBoot之@Scheduled注解用法解讀

更新時間：2025年03月24日 16:42:35 作者：王小工

這篇文章主要介紹了SpringBoot之@Scheduled注解用法,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教

SpringBoot之@Scheduled注解用法

@Scheduled 是 Spring Framework 中用于實(shí)現(xiàn)定時任務(wù)的核心注解，能夠方便地配置方法在特定時間或周期執(zhí)行。

以下是詳細(xì)解析：

1. 啟用定時任務(wù)‌

在 Spring Boot 中，需在配置類添加 @EnableScheduling 注解以啟用定時任務(wù)支持：

@Configuration
@EnableScheduling
public class AppConfig {
}

‌2. 基本用法‌

直接在方法上添加 @Scheduled 注解，并配置執(zhí)行規(guī)則：

@Component
public class ScheduledTasks {

    // 固定延遲（任務(wù)結(jié)束后的間隔）
    @Scheduled(fixedDelay = 5000)
    public void taskWithFixedDelay() {
        // 每隔5秒執(zhí)行一次（任務(wù)完成后開始計(jì)時）
    }

    // 固定速率（任務(wù)開始的間隔）
    @Scheduled(fixedRate = 3000)
    public void taskWithFixedRate() {
        // 每隔3秒執(zhí)行一次（任務(wù)開始后開始計(jì)時）
    }

    // 初始延遲（首次執(zhí)行前的等待時間）
    @Scheduled(initialDelay = 10000, fixedRate = 5000)
    public void taskWithInitialDelay() {
        // 首次延遲10秒，之后每隔5秒執(zhí)行一次
    }

    // Cron表達(dá)式（復(fù)雜時間規(guī)則）
    @Scheduled(cron = "0 0 12 * * ?")
    public void taskWithCronExpression() {
        // 每天中午12點(diǎn)執(zhí)行
    }
}

‌3. 參數(shù)詳解‌

‌(1) fixedDelay‌

作用‌：任務(wù)結(jié)束后的固定延遲時間（單位：毫秒）。
示例‌：@Scheduled(fixedDelay = 5000) 表示任務(wù)結(jié)束后等待5秒再執(zhí)行下一次。
適用場景‌：需確保前一次任務(wù)完成后再執(zhí)行下一次。

‌(2) fixedRate‌

作用‌：任務(wù)開始的固定時間間隔（單位：毫秒）。
‌示例‌：@Scheduled(fixedRate = 3000) 表示每隔3秒執(zhí)行一次（無論前一次任務(wù)是否完成）。
注意‌：若任務(wù)執(zhí)行時間超過間隔時間，可能導(dǎo)致任務(wù)重疊（需結(jié)合線程池配置）。

‌(3) initialDelay‌

作用‌：首次任務(wù)執(zhí)行前的初始延遲時間（單位：毫秒）。
‌示例‌：@Scheduled(initialDelay = 10000, fixedRate = 5000) 表示首次延遲10秒后執(zhí)行，之后每隔5秒執(zhí)行一次。

‌(4) cron‌

‌作用‌：通過 Cron 表達(dá)式定義復(fù)雜調(diào)度規(guī)則。
Cron 表達(dá)式格式‌：秒分時日月周年（可選）
‌常用示例‌：
- 0 0 10 * * ?：每天上午10點(diǎn)執(zhí)行。
- 0 0/5 14 * * ?：每天下午2點(diǎn)開始，每隔5分鐘執(zhí)行一次。
- 0 15 10 ? * MON-FRI：每周一至周五上午10:15執(zhí)行。
‌在線工具‌：推薦使用 Cron表達(dá)式生成器。

‌4. 線程池配置‌

默認(rèn)情況下，定時任務(wù)使用單線程執(zhí)行。若任務(wù)耗時較長，需配置線程池避免阻塞：

@Configuration
public class SchedulerConfig implements SchedulingConfigurer {

    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        taskRegistrar.setScheduler(taskExecutor());
    }

    @Bean(destroyMethod = "shutdown")
    public Executor taskExecutor() {
        return Executors.newScheduledThreadPool(10); // 自定義線程數(shù)
    }
}