排程每天默默不執行,又不報錯——APScheduler 在 Windows 的 misfire 坑
最近有很多需要定期執行的項目,用 APScheduler 排好時間後,想說設定完就不用再管它。結果某天發現它沒正常運作,連續好幾天都沒動靜,但程式看起來一切正常,也沒噴任何錯誤,第一直覺就是自己程式一定寫錯了(抖
通常程式掛掉,至少會留個 stack trace 給你查;但這次它根本不報錯。程式還活著、排程也還在,log 翻過去一條紅字都沒有,就是該跑的時間到了,什麼事都沒發生。活著、但不做事。
問題出在「遲到一秒就不算數」
仔細翻 log,才看到一行不起眼的訊息,排程的執行時間「was missed by」幾秒。
查了一下,終於找到原因,原來 APScheduler 有個參數叫 misfire_grace_time,預設只有 1 秒。意思是,排程到點時,如果因為某些原因晚了超過 1 秒才輪到它,APScheduler 就判定這次「misfire(錯過了)」,直接跳過不執行。
我這次是在 Windows 上跑。APScheduler 的排程跑在你自己的程式裡,到了該執行的時間,只要程式當下沒能馬上輪到它,就可能晚超過這 1 秒。個人電腦常見的睡眠、休眠,或當下負載偏高、排程執行緒被前一個工作卡住,都會造成這種延遲,放在會自動睡眠的機器上又特別容易遇到。於是每天到了該跑的時間,它就被判定 misfire、整天跳過。
對 APScheduler 來說,這是「照規則跳過」,不是錯誤。
解法:把寬限時間放大
知道原因之後,解法很簡單,把 misfire_grace_time 設大一點,給它足夠的寬限。
1 | scheduler.add_job( |
我設成 3600(一小時)。對「每天推一次」這種排程來說,晚個幾秒、甚至幾分鐘都無所謂,重點是它要跑。改完之後,每天都正常推了。
這裡可能會有個疑問,既然問題出在 Windows,為什麼不乾脆用 Windows 內建的 Task Scheduler?
因為我這支程式希望可以同時在 Mac 跟 Windows 上跑,APScheduler 讓我用同一套 Python 排程兩邊通用,不必為每個作業系統各維護一份排程設定。換個角度看,這個 misfire 坑算是把排程放進程式裡、換取跨平台便利的代價。
這個坑的麻煩不在難解,在難發現,它躲在一行 log 裡,表面上什麼都正常。整件事最好笑的是,根因不過是一個預設 1 秒的參數,我一直以為是程式哪裡有問題,研究了一陣子,最後讓 AI 跑一下,馬上就揪出來。如果你的排程在 Windows 上「偶爾」或「整天」不執行又不報錯,先去翻 misfire_grace_time,省得跟我一樣繞遠路。