一、定时任务的基础实现

在SpringBoot中启用定时任务只需简单两步：

1. 在主类添加@EnableScheduling注解
   java @SpringBootApplication @EnableScheduling public class MyApplication { public static void main(String[] args) { SpringApplication.run(MyApplication.class, args); } }

2. 在方法上使用@Scheduled注解java
   @Service
   public class ReportGenerator {

   // 每天凌晨1点执行
   @Scheduled(cron = "0 0 1 * * ?")
   public void generateDailyReport() {
   // 业务逻辑实现
   }
   }

常见配置参数说明：
- fixedDelay：固定间隔（上次执行结束到下次开始）
- fixedRate：固定频率（上次开始到下次开始）
- initialDelay：初始延迟时间

二、动态定时任务进阶方案

实际项目中经常需要动态调整执行周期，这时可以使用ScheduledTaskRegistrar：

java
@Configuration
@EnableScheduling
public class DynamicScheduler implements SchedulingConfigurer {

@Override
public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
    taskRegistrar.addTriggerTask(
        () -> System.out.println("动态任务执行时间: " + new Date()),
        triggerContext -> {
            // 从数据库或配置中心获取cron表达式
            String cron = getCronFromDB(); 
            return new CronTrigger(cron).nextExecutionTime(triggerContext);
        }
    );
}

}

生产建议：
1. 将cron表达式存储在配置中心或数据库
2. 添加@RefreshScope支持热更新
3. 记录每次任务执行的开始/结束时间

三、分布式环境解决方案

在集群环境下需要解决重复执行问题，常见方案对比：

| 方案 | 优点 | 缺点 |
|---------------------|-----------------------|-----------------------|
| 数据库锁 | 实现简单 | 性能较差 |
| Redis分布式锁 | 性能较好 | 需处理锁续期问题 |
| ShedLock框架 | 开箱即用 | 依赖外部存储 |
| Quartz集群模式 | 功能完整 | 配置复杂 |

推荐实现（基于ShedLock）：
java @Scheduled(cron = "0 */15 * * * ?") @SchedulerLock(name = "reportTask", lockAtLeastFor = "5m") public void scheduledTask() { // 保证15分钟内只会执行一次 }

四、异常处理与监控

健壮的定时任务需要完善的异常处理机制：

1. 自定义异常处理器
   java @Bean public TaskScheduler taskScheduler() { ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler(); scheduler.setErrorHandler(t -> { // 发送告警通知 alertService.send("定时任务异常", t.getMessage()); // 记录异常日志 log.error("任务执行异常", t); }); return scheduler; }

2. 添加执行日志
   java @Around("@annotation(scheduled)") public Object logExecutionTime(ProceedingJoinPoint pjp, Scheduled scheduled) { long start = System.currentTimeMillis(); try { return pjp.proceed(); } finally { long duration = System.currentTimeMillis() - start; log.info("任务 {} 执行耗时: {}ms", pjp.getSignature(), duration); } }

五、性能优化实践

1. 线程池配置
   yaml spring: task: scheduling: pool: size: 10 thread-name-prefix: my-scheduler-

2. 任务分组管理
   java @Bean public TaskScheduler criticalTaskScheduler() { ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler(); scheduler.setPoolSize(5); scheduler.setThreadNamePrefix("critical-scheduler-"); scheduler.setWaitForTasksToCompleteOnShutdown(true); return scheduler; }

3. 优雅停机配置
   java @PreDestroy public void destroy() { scheduler.setWaitForTasksToCompleteOnShutdown(true); scheduler.shutdown(); }

六、常见问题排查清单

1. 任务不执行

- 检查是否添加@EnableScheduling
- 查看线程池是否已满
- 确认cron表达式是否正确

1. 任务重复执行

- 检查是否部署了多个实例
- 验证分布式锁是否生效

1. 执行时间漂移

- 检查任务耗时是否超过间隔时间
- 确认是否配置了fixedDelay而不是fixedRate

总结

SpringBoot定时任务从简单到复杂需要层层递进：从基础的@Scheduled注解开始，到动态调度能力的实现，再到分布式环境下的协调处理。生产环境中还需要考虑执行监控、性能优化和故障恢复等维度。建议根据实际业务场景选择合适的技术方案，对于复杂调度需求可以考虑集成Quartz等专业调度框架。

最佳实践路线图：
1. 简单任务 → 使用原生注解
2. 动态需求 → ScheduledTaskRegistrar
3. 分布式环境 → ShedLock/Quartz
4. 生产级需求 → 完善监控+告警+日志