Spring  @Scheduled中这些参数的区别、组合和应用场景解析

// 每天凌晨1点执行
@Scheduled(cron = "0 0 1 * * ?")
// 每5分钟执行（在每分钟的0秒执行）
@Scheduled(cron = "0 */5 * * * ?")
// 每小时的10分、30分、50分执行
@Scheduled(cron = "0 10,30,50 * * * ?")

// 每5分钟执行一次（从上次开始算起）
@Scheduled(fixedRate = 5 * 60 * 1000)

// 上次执行结束后，等待5分钟再执行下次
@Scheduled(fixedDelay = 5 * 60 * 1000)

// 应用启动后等待10分钟，然后每5分钟执行一次
@Scheduled(initialDelay = 10 * 60 * 1000, fixedRate = 5 * 60 * 1000)

// 情况1：fixedRate = 5分钟
// 时间线：0分开始→2分结束→5分开始→7分结束→10分开始...
// 实际间隔：3分钟（5-2）
// 情况2：fixedDelay = 5分钟  
// 时间线：0分开始→2分结束→7分开始→9分结束→14分开始...
// 实际间隔：7分钟（2+5）
// 情况3：cron = "0 */5 * * * ?"
// 时间线：0分开始→2分结束→5分开始→7分结束→10分开始...
// 实际间隔：3分钟，但开始时间固定在0、5、10分

@Component
public class DataSyncScheduler {
    // 应用启动后等待2小时（让其他服务就绪），然后每30分钟同步一次
    @Scheduled(initialDelay = 2 * 60 * 60 * 1000, 
               fixedRate = 30 * 60 * 1000)
    public void syncData() {
        // 数据同步任务，执行时间较短
    }
}

@Component
public class ReportGenerator {
    // 应用启动后等待5分钟，然后每次执行结束后等待1小时再执行
    @Scheduled(initialDelay = 5 * 60 * 1000, 
               fixedDelay = 60 * 60 * 1000)
    public void generateReport() {
        // 生成报表，执行时间较长（约10-20分钟）
        // 保证每次生成完成后，休息1小时再开始
    }
}

@Component
public class MaintenanceTask {
    @PostConstruct
    public void init() {
        // 计算到下一个整点的延迟
    }
    @Scheduled(cron = "0 0 */2 * * ?", zone = "Asia/Shanghai")
    public void maintenance() {
        // 每2小时在整点执行系统维护
    }
}

// 工作日早上9点执行
@Scheduled(cron = "0 0 9 * * MON-FRI")
// 每小时的第5分钟执行
@Scheduled(cron = "0 5 * * * ?")
// 每月1号凌晨2点执行
@Scheduled(cron = "0 0 2 1 * ?")

// 实时监控，频率优先
@Scheduled(fixedRate = 30 * 1000)  // 每30秒
// 频繁的小任务
@Scheduled(fixedRate = 5 * 1000)   // 每5秒

// 处理大量数据，需要间隔
@Scheduled(fixedDelay = 10 * 60 * 1000)  // 每次间隔10分钟
// 调用有限制的第三方API
@Scheduled(fixedDelay = 2 * 1000)  // 每次间隔2秒，避免限流

// Spring Cloud 配置，等待配置中心就绪
@Scheduled(initialDelay = 30 * 1000, fixedRate = 60 * 1000)
// 缓存预热后再执行
@Scheduled(initialDelay = 2 * 60 * 1000, cron = "0 */15 * * * ?")

@Component
public class CustodySyncService {
    @PostConstruct
    public void init() {
        // 可以在这里计算动态的 initialDelay
    }
    // 方案1：使用 cron + 动态初始延迟（需要自己实现）
    // 方案2：使用 fixedRate + 计算的 initialDelay
    // 如果坚持要整点开始，建议：
    @Scheduled(cron = "0 */5 * * * ?")
    public void syncCustody() {
        // 这种会固定在 :00, :05, :10 执行
    }
    // 如果要从启动时间算，每5分钟：
    @Scheduled(fixedRate = 5 * 60 * 1000)
    public void syncCustody2() {
        // 从启动开始算，每5分钟执行
        // 首次执行是启动后立即执行，除非配合 initialDelay
    }
}

# application.yml
scheduling:
  tasks:
    custody-sync:
      # 从配置读取，方便不同环境调整
      fixed-rate: 300000  # 5分钟
      initial-delay: ${SYNC_INITIAL_DELAY:120000}  # 默认2分钟
      enabled: true