Java注解篇：@Scheduled-CSDN博客

本文链接：https://blog.csdn.net/weixin_45277068/article/details/147893767

前言

在日常开发中，定时任务是一类非常常见的功能需求。Spring 框架为了让开发者更轻松地使用定时任务，提供了一个功能强大的注解：@Scheduled。它可以方便地通过配置表达式来定义任务的执行时间，大幅简化了任务调度的复杂度。

本文将全面介绍 @Scheduled 注解的用法、属性、实现原理以及一些实战案例，帮助开发者更深入地理解其背后的机制。

一、基础介绍

@Scheduled 是 Spring Framework 提供的一个注解，主要用于标注方法，使其在指定时间或时间间隔上定期执行。该注解可与 Spring 的任务调度模块配合使用。

要使用 @Scheduled 注解，需要在配置类上添加 @EnableScheduling 注解以启用定时任务功能。

示例代码：

@Configuration
@EnableScheduling
public class SchedulerConfig {
}

@Component
public class MyTask {
    @Scheduled(fixedRate = 5000)
    public void executeTask() {
        System.out.println("任务执行时间: " + LocalDateTime.now());
    }
}

二、常用属性详解

@Scheduled 注解提供了以下几种常用的参数方式，用于定义任务调度的频率与时间：

1. fixedRate：按固定速率执行

单位为毫秒，表示任务之间的执行时间间隔（不管上一次是否完成）
示例：@Scheduled(fixedRate = 5000)

2. fixedDelay：按固定延迟执行

单位为毫秒，表示上一个任务完成后，延迟多少时间再次执行
示例：@Scheduled(fixedDelay = 5000)

3. initialDelay：初始延迟

表示延迟多少毫秒后再第一次执行任务
通常与 fixedRate 或 fixedDelay 搭配使用
示例：@Scheduled(initialDelay = 1000, fixedRate = 5000)

4. cron：Cron 表达式

最为灵活的方式，允许开发者通过表达式指定任意的时间粒度
示例：@Scheduled(cron = "0 0 12 * * ?") 表示每天中午12点执行一次

Cron表达式格式：

秒(0-59) 分(0-59) 时(0-23) 日(1-31) 月(1-12) 星期(0-7或SUN-SAT) 年(可选)

示例解释：

@Scheduled(cron = "0 0/5 * * * ?")：每5分钟执行一次
@Scheduled(cron = "0 0 9-18 * * MON-FRI")：周一到周五，9点到18点整点执行

三、实现原理解析

1. 启用定时任务机制

当使用 @EnableScheduling 注解时，Spring 会自动扫描带有 @Scheduled 的方法，并将其注册为定时任务。

2. 内部类分析

Spring 定时任务核心类如下：

ScheduledAnnotationBeanPostProcessor：用于解析 @Scheduled 注解
TaskScheduler：调度器接口，Spring默认实现为 ThreadPoolTaskScheduler

3. 工作机制

启动时，ScheduledAnnotationBeanPostProcessor 会扫描所有 Bean 方法，查找 @Scheduled 注解
对符合条件的方法生成 ScheduledTask
交由 TaskScheduler 统一调度

4. 多线程支持

默认 TaskScheduler 是单线程的，如需使用线程池调度多个任务，可以自定义 TaskScheduler：

@Configuration
public class SchedulerConfig {
    @Bean
    public TaskScheduler taskScheduler() {
        ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
        scheduler.setPoolSize(5);
        scheduler.setThreadNamePrefix("my-scheduler-");
        return scheduler;
    }
}

四、注意事项

1. 方法必须是 `void` 且无参数

@Scheduled(fixedRate = 5000)
public void doTask() {}

2. 异常处理

如果方法抛出异常，会中断后续任务执行，因此要添加异常捕获：

@Scheduled(fixedRate = 5000)
public void safeTask() {
    try {
        // your code
    } catch (Exception e) {
        e.printStackTrace();
    }
}

3. cron 表达式时区问题

默认使用服务器时区，如需指定时区：

@Scheduled(cron = "0 0 12 * * ?", zone = "Asia/Shanghai")

五、实战案例

1. 每日发送邮件提醒

@Component
public class EmailReminderTask {
    @Scheduled(cron = "0 0 9 * * ?")
    public void sendDailyReminders() {
        emailService.sendReminders();
    }
}

2. 每5分钟清理缓存

@Component
public class CacheCleaner {
    @Scheduled(fixedRate = 300000)
    public void cleanCache() {
        cacheService.clear();
    }
}

3. 初始延迟执行任务

@Component
public class InitDelayTask {
    @Scheduled(initialDelay = 10000, fixedDelay = 5000)
    public void delayedTask() {
        System.out.println("延迟启动任务");
    }
}

六、与 Spring Boot 配合使用

在 Spring Boot 中使用定时任务更加简单，无需 XML 配置，仅需添加注解和方法即可。

示例：

@SpringBootApplication
@EnableScheduling
public class ScheduledApplication {
    public static void main(String[] args) {
        SpringApplication.run(ScheduledApplication.class, args);
    }
}