如何让Quartz v1.x有状态任务忽略长耗时期间错过的调度？

我之前维护Quartz v1.x定时任务时也碰到过完全一样的情况——有状态任务偶尔跑超时，结束后就会一股脑补跑所有错过的触发，确实挺头疼的。不过Quartz本身就提供了配置项来解决这个问题，核心就是调整错过触发（Misfire）的处理策略。

核心原理 #

默认情况下，Quartz会记录任务错过的所有触发点，当任务最终完成后，会依次补跑这些错过的执行。我们需要把策略改成「忽略所有错过的触发，直接按原计划执行下一次调度」。

具体配置方式 #

1. 编程式创建Trigger时设置

如果是通过代码创建SimpleTrigger，直接设置misfireInstruction为SimpleTrigger.MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY即可：

// 定义有状态Job（v1.x使用@StatefulJob注解）
@StatefulJob
public class MyLongRunningJob implements Job {
    @Override
    public void execute(JobExecutionContext context) throws JobExecutionException {
        // 你的任务业务逻辑
    }
}

// 创建并配置Trigger
SimpleTrigger trigger = new SimpleTrigger("MyTaskTrigger", Scheduler.DEFAULT_GROUP);
trigger.setJobName("MyLongRunningJob");
trigger.setJobGroup(Scheduler.DEFAULT_GROUP);
trigger.setRepeatInterval(60000); // 设置1分钟重复间隔
trigger.setRepeatCount(SimpleTrigger.REPEAT_INDEFINITELY); // 无限重复执行
// 关键配置：忽略所有错过的触发请求
trigger.setMisfireInstruction(SimpleTrigger.MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY);

// 将Trigger注册到调度器
scheduler.scheduleJob(trigger);

2. XML配置方式

如果是用Spring XML或Quartz原生XML配置，在<trigger>标签里添加misfire-instruction属性：

<job-detail>
    <job-name>MyLongRunningJob</job-name>
    <job-class>com.yourpackage.MyLongRunningJob</job-class>
    <stateful>true</stateful> <!-- 标记为有状态任务，自动禁止并行执行 -->
</job-detail>

<trigger>
    <simple>
        <name>MyTaskTrigger</name>
        <job-name>MyLongRunningJob</job-name>
        <repeat-interval>60000</repeat-interval>
        <repeat-count>-1</repeat-count> <!-- -1表示无限重复 -->
        <!-- 关键配置：忽略错过的触发 -->
        <misfire-instruction>IGNORE_MISFIRE_POLICY</misfire-instruction>
    </simple>
</trigger>

注意事项 #

• 这个策略只对已经错过的触发生效，任务回到正常状态后，后续调度仍会按原1分钟间隔执行。
• 你的任务是有状态的（@StatefulJob或XML中的<stateful>true</stateful>），Quartz已经自动禁止了并行执行，无需额外处理并发问题。
• 注意区分Quartz版本：v1.x使用@StatefulJob标记有状态任务，而v2+中该注解已过时，改用@DisallowConcurrentExecution，这里要严格适配v1.x的API。

这样设置后，当任务因为超时错过N次触发时，它结束后不会补跑这N次，直接等待下一个1分钟的调度点执行就好啦。

内容的提问来源于stack exchange，提问作者Csaba Faragó