SpringBoot整合Quartz JDBC存储时任务未按Cron表达式执行

核心原因 #

这是Quartz切换持久化存储后的高频问题，和贴出的代码、默认配置强相关，两个触发点按概率从高到低排列：

• Misfire策略配置未生效+默认阈值卡触发间隔
  Quartz内存模式没有数据库IO开销，几乎不会触发misfire判定，但JDBC模式下每次任务触发、状态更新都要操作数据库，存在固有延迟。Quartz JDBC模式默认的misfire（错过触发）判定阈值为60000ms（1分钟），刚好和配置的1分钟执行间隔持平，只要数据库操作有1秒以上的延迟，就会判定本次触发错过。
  代码中配置的withMisfireHandlingInstructionDoNothing()（错过触发后不跳过、立即执行）完全没有生效：CronScheduleBuilder采用不可变Builder设计，所有配置方法都会返回新的Builder对象，没有接收该方法的返回值，实际运行时用的还是默认的misfire策略——直接跳过所有错过的触发周期，调度下一个合法时间点的任务，最终就出现隔1分钟执行一次的现象，和贴出的奇数分钟执行、偶数分钟全跳过的日志完全吻合。
  无效代码片段：

  // 这行代码白写，没有修改原csb对象的配置
  csb.withMisfireHandlingInstructionDoNothing();
  

• 触发器扫描间隔配置不合理/多实例未开集群
  如果配置中触发器拉取间隔（triggerAcquisitionInterval）大于等于60秒，调度线程每分钟才扫描一次待执行任务，很容易错过触发窗口；如果启动了多个服务实例连同一个Quartz数据库，但没开启集群模式，会出现数据库锁竞争，也会导致触发跳过。

修复步骤 #

按顺序调整即可解决：

• 修正CronTrigger的代码写法，用链式调用保证misfire策略真正生效：

  @Bean
  public Trigger emailTrigger() {
      // 链式调用挂载所有配置，避免丢失配置项
      CronScheduleBuilder csb = CronScheduleBuilder.cronSchedule("0 0/1 * * * ?")
              .withMisfireHandlingInstructionDoNothing();
      return TriggerBuilder.newTrigger().forJob(taskJobDetail()).withIdentity("task", "task")
              .withSchedule(csb).build();
  }
  

• 调整Quartz配置参数，给数据库IO留足冗余，以yml配置为例：

  spring:
    quartz:
      properties:
        org:
          quartz:
            jobStore:
              # misfire判定阈值调整为2分钟，大于任务触发间隔，避免正常IO延迟被误判
              misfireThreshold: 120000
              # 触发器扫描间隔设为5秒，保证及时拉取待执行任务
              triggerAcquisitionInterval: 5000
            scheduler:
              # 调度线程空闲等待时间设为5秒
              idleWaitTime: 5000
  

• 若需要多实例部署连同一个Quartz库，必须开启集群配置避免锁竞争：

  spring:
    quartz:
      properties:
        org:
          quartz:
            jobStore:
              isClustered: true
              clusterCheckinInterval: 10000
  

调整完重启服务，任务就会严格按每分钟1次的规则执行，不会再出现间隔拉长的问题。

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