Jenkins能否配置处理misfired任务 服务器重启后补跑未执行的Python脚本
Jenkins停机场景下错过调度任务(misfired jobs)的补跑能力说明
核心结论
- 可通过Jenkins的原生配置实现对停机期间错过调度任务的状态记忆与重启后自动补执行,但默认配置不满足停机2天的补跑要求,需要调整对应调度参数。
原生调度的默认行为
Jenkins底层基于Quartz调度框架实现定时任务触发逻辑,默认的misfire(错过触发)判定规则为:
- 服务重启恢复后,会自动遍历所有配置了定时构建的任务,对比每个任务的计划触发时间与当前时间的差值
- 默认判定阈值为:如果错过的触发节点距离服务恢复的时间小于2分钟,才会自动执行补跑;如果错过时间超过阈值,直接丢弃该次触发,不做任务执行。
- 该默认阈值是为了避免服务器长时间停机后,Jenkins重启瞬间批量补跑大量历史任务造成系统负载雪崩。
适配2天停机场景的调整配置
要支持停机2天期间的错过任务补跑,需要调整全局的misfire判定窗口,将阈值拉长至大于2天的时长:
- 临时生效的调整方式:进入Jenkins全局管理的
脚本命令行页面,执行以下Groovy脚本,将判定窗口设置为3天(72小时),覆盖2天停机的时间差:// 单位为毫秒,此处设置为3天的时长 Jenkins.instance.quartzScheduler.managementContext.setMisfireThreshold(3 * 24 * 60 * 60 * 1000) - 永久生效的调整方式:在
$JENKINS_HOME/init.groovy.d/目录下新建groovy脚本文件,写入上述配置逻辑,Jenkins每次启动时会自动加载该配置,无需手动重复执行脚本。
补跑过程的关键注意事项
- 任务补跑会按照错过的触发时间顺序串行执行,不会自动跳过或合并重复触发:如果2天内一个每小时触发一次的Python脚本,累计错过了48次触发,服务恢复后会连续串行执行48次任务,需要提前评估补跑对脚本依赖的下游系统(数据库、外部接口、文件存储等)的压力。
- 参数化任务的补跑会严格使用历史触发点对应的参数值执行,不会使用任务当前最新的默认参数覆盖历史配置。
- 如果任务是通过第三方调度插件实现的定时触发,需要单独核对对应插件的misfire处理逻辑,部分插件默认不支持跨长时间停机的补跑能力,需要在插件配置中单独开启"服务重启后补跑错过任务"的开关。
内容的提问来源于stack exchange,提问作者Angel
相关产品推荐
相关产品推荐

