使用Java Quartz 2.3.2计算Cron表达式nextFireTime返回null，求问题原因

使用Java Quartz 2.3.2版本计算Cron表达式的下次执行时间时，nextFireTime属性始终返回null。Cron表达式验证有效，代码实现及测试用例如下：

public LocalDateTime cronExpression(String cronExpression, LocalDateTime startDate) {
    try {
        CronExpression cron = new CronExpression(cronExpression);
        CronTrigger trigger = TriggerBuilder.newTrigger()
                .withSchedule(CronScheduleBuilder.cronSchedule(cron))
                .startAt(Date.from(startDate.atZone(ZoneId.systemDefault()).toInstant())).
                build();

        Date nextExecutionTime = trigger.getNextFireTime();
        return nextExecutionTime.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
    } catch (ParseException e) {
        LOGGER.debug("Error parsing cron expression {}", e.getMessage());
    } catch (Exception e) {
        LOGGER.debug("Unexpected error {}", e.getMessage());
    }
    return null;
}

@Test
void test() throws ParseException {
    String cronExpression = "0 0 10 1/1 * ? *";
    LocalDateTime startDate = LocalDateTime.of(2024, 4, 1, 15, 0);

    LocalDateTime nextExecutionTime = jobSchedulingService.calculateNextExecutionTime(cronExpression, startDate);

    assertNotNull(nextExecutionTime);
    assertEquals(startDate.plusHours(1), nextExecutionTime);
}

错误原因 #

1. Trigger获取执行时间的方式错误：仅通过Trigger.getNextFireTime()无法得到正确结果，因为Quartz的Trigger在未关联到Scheduler时，不会自动计算下次执行时间。
2. 测试用例预期结果不符合Cron规则：你的Cron表达式0 0 10 1/1 * ? *表示每天上午10点执行，测试中startDate为2024-04-01 15:00，下次执行时间应为2024-04-02 10:00，而非startDate.plusHours(1)。

修正方案 #

直接使用CronExpression内置的getNextValidTimeAfter()方法计算下次执行时间，无需构建Trigger：

优化后的核心方法 #

public LocalDateTime calculateNextExecutionTime(String cronExpression, LocalDateTime startDate) {
    try {
        CronExpression cron = new CronExpression(cronExpression);
        Date startDateObj = Date.from(startDate.atZone(ZoneId.systemDefault()).toInstant());
        Date nextExecutionTime = cron.getNextValidTimeAfter(startDateObj);
        
        if (nextExecutionTime != null) {
            return nextExecutionTime.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
        }
    } catch (ParseException e) {
        LOGGER.debug("解析Cron表达式错误: {}", e.getMessage());
    } catch (Exception e) {
        LOGGER.debug("意外错误: {}", e.getMessage());
    }
    return null;
}

修正后的测试用例 #

@Test
void testCalculateNextExecutionTime() throws ParseException {
    String cronExpression = "0 0 10 1/1 * ? *";
    LocalDateTime startDate = LocalDateTime.of(2024, 4, 1, 15, 0);
    LocalDateTime expectedNextTime = LocalDateTime.of(2024, 4, 2, 10, 0);

    LocalDateTime nextExecutionTime = jobSchedulingService.calculateNextExecutionTime(cronExpression, startDate);

    assertNotNull(nextExecutionTime);
    assertEquals(expectedNextTime, nextExecutionTime);
}

补充说明 #

• CronExpression.getNextValidTimeAfter()是Quartz专门设计的Cron时间计算API，无需依赖Scheduler或Trigger实例，计算结果准确可靠。
• 注意时区一致性，示例使用系统默认时区，若业务需要固定时区（如UTC），可替换为ZoneId.of("UTC")。

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