SpringBoot @Scheduled 注解详解

让方法周期性自动执行，轻松实现定时任务！

作用

为方法添加定时任务功能，支持按固定间隔、延迟或Cron表达式触发执行。 基于Spring Task调度，适用于日志清理、数据同步等周期性场景。

使用方法

1. 启用定时任务 启动类添加 @EnableScheduling：

@SpringBootApplication
@EnableScheduling
public class App { ... }

1. 标注需执行的方法

在方法上添加 @Scheduled，并指定触发规则：

@Component
public class TaskService {

    // 方式1：固定速率（间隔时间包含任务执行时间）
    @Scheduled(fixedRate = 5000)  // 每5秒执行一次
    public void task1() { ... }

    // 方式2：固定延迟（任务完成后间隔指定时间）
    @Scheduled(fixedDelay = 3000)  // 任务结束3秒后再次执行
    public void task2() { ... }

    // 方式3：Cron表达式（灵活控制时间）
    @Scheduled(cron = "0 0 2 * * ?")  // 每天凌晨2点执行
    public void task3() { ... }
}

注意点

• 单线程阻塞：默认单线程执行任务，耗时任务会阻塞后续任务 → 需配置线程池（示例）：

@Configuration
public class ScheduleConfig implements SchedulingConfigurer {
    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        taskRegistrar.setScheduler(Executors.newScheduledThreadPool(5));
    }
}

• 时区问题：Cron表达式默认使用服务器时区 → 指定时区：@Scheduled(cron="0 0 0 * * ?", zone="Asia/Shanghai")
• 分布式问题：多实例部署会导致任务重复执行 → 结合Redis锁或使用分布式调度框架（如Quartz）。

Cron表达式详解

格式：秒 分 时 日 月 周 年（可选）

常用符号

• *：任意值
• ?：不指定（用于日或周字段冲突时）
• -：范围（如 10-20）
• /：间隔（如 0/5 秒 → 每5秒）
• L：最后一天（日）/ 最后一周（周）
• W：最近工作日（如 15W 当月15日最近的工作日）

高频Cron表达式表

（6位格式：秒 分 时 日 月 周，兼容Spring Task）

特殊规则扩展表

在这里插入图片描述

注意事项

1. 验证工具：使用 Cron表达式在线生成器 或 IDEA插件校验合法性。
2. 时区问题：默认跟随服务器时区，可通过 zone = "GMT+8" 显式指定（如北京时间）。
3. 性能避坑：避免秒级高频任务导致线程阻塞，必要时结合 @Async 异步执行。

📌 复制即用，效率翻倍！

最佳实践

• 轻量级任务用 @Scheduled，复杂场景用 Quartz。
• 任务方法避免长时间阻塞，必要时拆分成异步任务（@Async）。
• 通过 cron-validator 库或在线工具校验表达式合法性。

掌握 @Scheduled，轻松实现精准调度！ 🚀