
APScheduler 中 jitter 参数仅用于在触发时间附近随机偏移单次执行时刻,不会导致同一任务多次运行;真正的问题是程序重启时未清理旧作业,导致每天新增一个相同任务,形成累积式重复调用。
apscheduler 中 `jitter` 参数仅用于在触发时间附近随机偏移单次执行时刻,不会导致同一任务多次运行;真正的问题是程序重启时未清理旧作业,导致每天新增一个相同任务,形成累积式重复调用。
你遇到的“每天执行次数递增”现象(如第一天 2 次、第二天 3 次),并非 jitter=900 引起——jitter 的作用只是为每次计划触发添加 ±15 分钟的随机扰动(例如将原本固定 9:00 的 cron 触发,随机变为 8:47–9:15 之间的某个时刻),它不会生成额外的调度实例,更不会改变任务数量。
真正的问题藏在你的启动逻辑中:
sched.add_job(Function, 'cron', hour=9, jitter=900)
sched.start()
try:
while True:
time.sleep(2)
except (KeyboardInterrupt, SystemExit):
sched.shutdown()
这段代码本身没有问题,但如果进程被外部机制(如 systemd 定时重启、Supervisor 进程守护、云平台健康检查杀进程、或人为 nightly restart)每日中断并重新拉起,那么每次启动都会执行 sched.add_job(...) —— 而 APScheduler 默认不会自动去重。结果就是:
- 第 1 天:注册 1 个
Function任务 → 后续每天触发 1 次(带 jitter); - 第 2 天:进程重启 → 再注册 1 个同名/同逻辑任务 → 调度器内共 2 个独立 job;
- 第 3 天:再重启 → 注册第 3 个 job → 每天最多可能触发 3 次(每个 job 各自按 cron + jitter 独立计算下次运行时间)。
你日志中看到的:
Running job "Function (trigger: cron[hour='9'], next run at: 2025-04-19 08:55:31 PDT)"
说明该 job 实例已被调度器识别为“已存在”,但它不是同一个 job 实例——而是新注册的第 N 个同名 job,其 next_run_time 是根据当前时间 + cron 规则 + jitter 独立计算得出的,因此会出现间隔仅 7 分钟的连续触发(不同 job 实例的 jitter 偏移恰好接近)。
✅ 正确做法:确保 job 全局唯一,避免重复注册
推荐两种健壮方案:
方案一:使用 replace_existing=True(推荐)
sched.add_job(
Function,
'cron',
hour=9,
jitter=900,
id='daily_function_job', # 必须指定唯一 ID
replace_existing=True # 冲突时替换而非报错/新增
)
方案二:启动前先移除同名 job(防御性写法)
job_id = 'daily_function_job'
if sched.get_job(job_id):
sched.remove_job(job_id)
sched.add_job(Function, 'cron', hour=9, jitter=900, id=job_id)
⚠️ 注意事项:
-
jitter仅影响「单次触发时间」,不控制「执行频次」或「job 数量」; - 所有长期运行的 APScheduler 实例必须配合进程生命周期管理(如使用
systemd的Restart=on-failure而非always,或禁用自动重启策略); - 生产环境建议启用
coalesce=True(默认True)和max_instances=1(防止单次因阻塞导致堆积),例如:sched.add_job( Function, 'cron', hour=9, jitter=900, id='daily_function_job', replace_existing=True, coalesce=True, # 同一 job 若错过多次,只执行最新一次 max_instances=1 # 确保同一 job 不会并发运行多个实例 )
总结:排查调度异常,优先确认 job 注册逻辑是否幂等,而非归咎于 jitter。稳定性源于可控的初始化,而非依赖随机性参数。










