Quartz CronTrigger未按指定startAt()时间触发问题咨询

我之前也遇到过类似的坑，这本质是对CronTrigger的startAt()方法作用理解有误导致的，下面给你拆解原因和解决方案：

问题根源 #

CronTrigger的startAt()并不是用来指定首次触发时间的，它的核心作用是定义触发器的生效起始阈值——也就是说，只有在startAt之后的时间点，才会去匹配你的Cron表达式规则来触发任务。

回到你的场景：你设置Cron表达式为每日18:00执行，同时把startAt设为2018-03-27 17:00。如果当前时间已经过了17:00，Quartz会自动寻找在startAt之后的下一个符合Cron规则的时间点，也就是次日18:00，而不是你设置的17:00本身。因为CronTrigger只会严格按照你定义的Cron时间规则触发，startAt只是过滤掉这个时间点之前的无效匹配，不会额外在startAt时间触发一次。

解决方案 #

根据你的实际需求，分两种情况处理：

1. 希望首次在指定时间触发，之后按固定周期执行 #

如果你的需求是先在当天17:00执行一次，之后每天18:00执行，那需要结合SimpleTrigger和CronTrigger来实现：

• 用SimpleTrigger专门处理首次触发，只执行一次；
• 用CronTrigger处理后续的每日固定时间任务，设置生效时间在首次触发之后即可。

Java代码示例：

// 首次触发的SimpleTrigger
SimpleTrigger firstTrigger = TriggerBuilder.newTrigger()
    .withIdentity("firstTrigger", "taskGroup")
    .startAt(DateUtils.parseDate("2018-03-27 17:00:00", "yyyy-MM-dd HH:mm:ss"))
    .withSchedule(SimpleScheduleBuilder.simpleSchedule().withRepeatCount(0)) // 仅执行一次
    .build();

// 后续每日执行的CronTrigger
CronTrigger dailyTrigger = TriggerBuilder.newTrigger()
    .withIdentity("dailyTrigger", "taskGroup")
    .startAt(DateUtils.parseDate("2018-03-27 17:01:00", "yyyy-MM-dd HH:mm:ss")) // 确保在首次触发后生效
    .withSchedule(CronScheduleBuilder.cronSchedule("0 0 18 * * ?"))
    .build();

// 将两个触发器绑定到同一个任务
scheduler.scheduleJob(jobDetail, firstTrigger);
scheduler.scheduleJob(dailyTrigger);

2. 仅需每日固定时间执行，从指定日期开始生效 #

如果你的需求只是从2018-03-27开始，每天18:00执行，那不需要把startAt设为17:00，直接将startAt设置为当天更早的时间（比如0点）或者当天18:00即可：

CronTrigger trigger = TriggerBuilder.newTrigger()
    .withIdentity("dailyTrigger", "taskGroup")
    .startAt(DateUtils.parseDate("2018-03-27 00:00:00", "yyyy-MM-dd HH:mm:ss")) // 当天0点起生效
    .withSchedule(CronScheduleBuilder.cronSchedule("0 0 18 * * ?"))
    .build();

如果当前时间还没到当天18:00，任务会在当天18:00触发；如果已经过了18:00，下一次触发就是次日18:00，这是符合预期的。

小技巧 #

你可以通过trigger.getNextFireTime()来提前验证触发器的下一次触发时间，这个值是Quartz根据Cron规则和startAt计算出的下一个有效时间点，能帮你快速排查配置是否正确。

内容的提问来源于stack exchange，提问作者Gautam Naik