式：字段規(guī)則、特殊字符與定時(shí)任務(wù)實(shí)戰(zhàn)指南)
1. 從理解到上手先把Cron表達(dá)式的底摸清定時(shí)任務(wù)大概是后臺(tái)開(kāi)發(fā)里最“日?！眳s又最容易被忽視的東西。你可能見(jiàn)過(guò)這樣的場(chǎng)景運(yùn)維同學(xué)半夜收到告警郵件上去一看是某個(gè)統(tǒng)計(jì)腳本沒(méi)跑開(kāi)發(fā)同學(xué)說(shuō)“我明明配了每天零點(diǎn)執(zhí)行”結(jié)果任務(wù)完全沒(méi)觸發(fā)還有更常見(jiàn)的——表達(dá)式寫(xiě)錯(cuò)導(dǎo)致任務(wù)在凌晨三點(diǎn)重復(fù)執(zhí)行數(shù)據(jù)庫(kù)被瞬時(shí)壓力打滿(mǎn)。這些事我基本都踩過(guò)一遍追到根上多數(shù)時(shí)候就是Cron表達(dá)式寫(xiě)得不嚴(yán)謹(jǐn)。Cron表達(dá)式本質(zhì)上就是一套用來(lái)描述“周期性時(shí)間點(diǎn)”的規(guī)則語(yǔ)言。很多人在初次接觸時(shí)只背了個(gè)七位格式覺(jué)得無(wú)非是“秒 分 時(shí) 日 月 周”真到了要寫(xiě)一個(gè)“每個(gè)工作日的上午9點(diǎn)半跑一次”的表達(dá)式時(shí)卻卡在了“?”和“*”的區(qū)別上。這篇內(nèi)容不搞教科書(shū)式的羅列而是從“為什么這樣設(shè)計(jì)”出發(fā)把字段規(guī)則、特殊字符、實(shí)際案例和踩坑經(jīng)驗(yàn)一并講透希望能幫你徹底掌握這一小塊卻極其關(guān)鍵的技能點(diǎn)。這套規(guī)則適用于哪些場(chǎng)景最典型的就是定時(shí)任務(wù)調(diào)度Java的Quartz框架、Spring的Scheduled注解、Linux系統(tǒng)的crontab命令、大數(shù)據(jù)平臺(tái)里的調(diào)度系統(tǒng)以及各類(lèi)數(shù)據(jù)同步、日志清理、報(bào)表生成任務(wù)。適合哪些人看如果你正在維護(hù)帶定時(shí)任務(wù)的系統(tǒng)、平時(shí)要寫(xiě)計(jì)劃任務(wù)腳本或者單純想弄明白“0 0 3 * * ?”到底怎么讀這篇文章都能給你實(shí)在的參考。2. 核心設(shè)計(jì)拆解Cron表達(dá)式為什么長(zhǎng)這樣2.1 煩瑣背后的邏輯為什么需要7個(gè)字段很多人剛接觸Cron時(shí)最不適應(yīng)的地方是它比常見(jiàn)的“5字段”格式多出了“秒”字段。某些系統(tǒng)里寫(xiě)“0 0 12 * * ?”是六位而在帶秒的場(chǎng)景下要寫(xiě)“0 0 12 * * ?”是六位而在Quartz里必須寫(xiě)成“0 0 12 * * ?”。傳統(tǒng)Linux crontab只有五位數(shù)分 時(shí) 日 月 周它不支持秒級(jí)精度。但Quartz這類(lèi)框架在設(shè)計(jì)時(shí)發(fā)現(xiàn)很多業(yè)務(wù)場(chǎng)景需要秒級(jí)別的觸發(fā)比如“每10秒刷新一次緩存”。于是它把字段擴(kuò)成了“秒 分 時(shí) 日 月 周 年可省略”。這也解釋了為什么網(wǎng)上經(jīng)常出現(xiàn)六位和七位混用的情況——大家用的SDK不同底層結(jié)構(gòu)就不一樣。自己寫(xiě)調(diào)度代碼時(shí)第一件事永遠(yuǎn)是確認(rèn)當(dāng)前用的是什么庫(kù)然后再談表達(dá)式怎么寫(xiě)。2.2 六位和七位少一個(gè)字段意味著什么有些框架比如Spring早期版本支持六位格式秒 分 時(shí) 日 月 周。七位格式則是在末尾加了“年”字段變成秒 分 時(shí) 日 月 周 年。年在絕大多數(shù)系統(tǒng)里用不到通常寫(xiě)成“*”或直接省略。如果某個(gè)調(diào)度器不支持年份字段你卻硬寫(xiě)了七位大概率會(huì)直接拋異常。你可以這樣理解六位和七位的關(guān)系就像“日期時(shí)間”和“日期時(shí)間年份”的關(guān)系。如果你只需要“每年6月1日?qǐng)?zhí)行”這種任務(wù)年份字段才有存在價(jià)值但實(shí)際業(yè)務(wù)里這類(lèi)需求很少更多是“每天”“每周幾”“每月幾號(hào)”這類(lèi)循環(huán)模式。所以我的經(jīng)驗(yàn)是優(yōu)先用六位別給自己找麻煩。2.3 每一位的取值邊界先搞懂才能談優(yōu)化Cron表達(dá)式拆開(kāi)后每一位的取值范圍和含義如下字段是否必填取值范圍允許的特殊字符秒是0-59, - * /分是0-59, - * /時(shí)是0-23, - * /日是1-31, - * ? / L W月是1-12 或 JAN-DEC, - * /周是1-7 或 SUN-SAT, - * ? / L #年可選否1970-2099, - * /這里必須強(qiáng)調(diào)一個(gè)高頻錯(cuò)誤日和周兩個(gè)字段是互斥的。如果你在“日”里寫(xiě)了具體的天數(shù)比如“15”那“周”就必須用“?”占位反過(guò)來(lái)也一樣。因?yàn)橄到y(tǒng)沒(méi)法同時(shí)判斷“每月15號(hào)”和“每周一”——這兩個(gè)條件同時(shí)生效時(shí)任務(wù)會(huì)在哪個(gè)點(diǎn)跑完全無(wú)法預(yù)測(cè)。這就是為什么“?”這個(gè)特殊字符在Cron表達(dá)式里有不可替代的地位。3. 特殊字符全解析從星號(hào)到問(wèn)號(hào)逐個(gè)擊破3.1 * 與 ?一對(duì)最容易混的兄弟“”在Cron里表示“任意值”相當(dāng)于通配符。舉個(gè)例子在“分”字段寫(xiě)“”意味著每分鐘都觸發(fā)在“時(shí)”字段寫(xiě)“*”意味著每小時(shí)都觸發(fā)?！?”的語(yǔ)義則完全不同它只用于“日”和“周”兩個(gè)字段表示“不指定值”。為什么需要這種語(yǔ)義正因?yàn)槿蘸椭芑コ猱?dāng)你設(shè)置了“日”字段時(shí)“周”就必須明確告訴系統(tǒng)“我不關(guān)心周幾”而這個(gè)“我不關(guān)心”就得用“?”來(lái)表達(dá)。我遇到過(guò)不少這樣的失誤在Spring的Scheduled注解里寫(xiě)“0 0 12 15 *”結(jié)果任務(wù)沒(méi)觸發(fā)日志里也沒(méi)有任何報(bào)錯(cuò)。原因就是“日”里寫(xiě)了15“周”里卻寫(xiě)了“”系統(tǒng)解析時(shí)把兩個(gè)條件同時(shí)生效了15號(hào)可能不是周一而周一可能不是15號(hào)條件疊加最終導(dǎo)致不匹配。正確寫(xiě)法是“0 0 12 15 * ?”。3.2 - 與 /范圍與步長(zhǎng)的聯(lián)合作戰(zhàn)“-”表示一個(gè)連續(xù)范圍。比如“小時(shí)”字段寫(xiě)“9-18”代表從上午9點(diǎn)到下午6點(diǎn)之間每個(gè)整點(diǎn)都觸發(fā)配合“分”字段的“0”就是“每天9點(diǎn)到18點(diǎn)的每分鐘或每小時(shí)整點(diǎn)執(zhí)行”。“/”表示步長(zhǎng)?！?/5”表示每隔5個(gè)單位執(zhí)行一次“0/15”表示從0開(kāi)始每隔15個(gè)單位執(zhí)行一次。這兩個(gè)字符合起來(lái)能完成很多常見(jiàn)配置。比如“每工作日的上午9點(diǎn)到下午6點(diǎn)之間每隔30分鐘執(zhí)行一次”可以寫(xiě)成“0 0/30 9-18 * * MON-FRI”。拆開(kāi)看秒位“0”表示整秒觸發(fā)分位“0/30”是從0分開(kāi)始每30分鐘一次時(shí)位“9-18”限制了小時(shí)范圍周位“MON-FRI”限制了工作日。這套組合在數(shù)據(jù)統(tǒng)計(jì)類(lèi)的定時(shí)任務(wù)里非常常見(jiàn)。3.3 L、W、#復(fù)雜日期需求的三件兵器“L”代表“最后一天”在不同字段里有不同含義在“日”字段表示月份的最后一天比如1月31日、4月30日在“周”字段單獨(dú)使用表示“星期六”即每周的最后一天跟在數(shù)字后面則代表“該月最后一個(gè)星期幾”比如“5L”表示該月最后一個(gè)星期五?！癢”代表“最近的工作日”只能用在“日”字段。比如“15W”表示“離15號(hào)最近的那個(gè)工作日”。如果15號(hào)是周六則觸發(fā)在周五14號(hào)如果15號(hào)是周日則觸發(fā)在周一16號(hào)。這個(gè)設(shè)計(jì)對(duì)“每月中旬的工作日?qǐng)?zhí)行賬務(wù)處理”這類(lèi)的業(yè)務(wù)非常有用?！?”則是“第幾個(gè)星期幾”只能用在“周”字段“6#3”表示“該月第三個(gè)星期五”按國(guó)外習(xí)慣周日是第一天6對(duì)應(yīng)周五。這三件兵器解決的都是“自然語(yǔ)言里的模糊時(shí)間描述”問(wèn)題。但如果系統(tǒng)本身沒(méi)有實(shí)現(xiàn)這些標(biāo)準(zhǔn)部分自研調(diào)度框架只支持基礎(chǔ)的五位格式你用了L、W、#反而會(huì)直接報(bào)錯(cuò)。所以用之前務(wù)必確認(rèn)框架的文檔。3.4 星期與月份的英文縮寫(xiě)寫(xiě)錯(cuò)一個(gè)字母排查半天Cron允許在月和周的字段使用英文縮寫(xiě)JAN-DEC對(duì)應(yīng)1-12月SUN-SAT對(duì)應(yīng)周日到周六。這里有一個(gè)容易混淆的點(diǎn)在Linux的crontab里周的數(shù)字“0”和“7”都表示周日有的系統(tǒng)把“7”也當(dāng)作周日但在Quartz里周的數(shù)字范圍是“1-7”其中“1”代表周日“7”代表周六。這兩種體系的語(yǔ)義正好錯(cuò)位如果從網(wǎng)上抄一個(gè)表達(dá)式時(shí)沒(méi)注意來(lái)源很容易翻車(chē)。我習(xí)慣的做法是無(wú)論是自己寫(xiě)還是審查別人的表達(dá)式一律使用英文縮寫(xiě)來(lái)標(biāo)記星期比如“MON-FRI”而不是“1-5”。這樣不僅可讀性強(qiáng)還能避免Quartz與Linux體系數(shù)字語(yǔ)義不一致的暗坑。4. 實(shí)操環(huán)節(jié)那些直接抄作業(yè)就能用的表達(dá)式4.1 每天定點(diǎn)執(zhí)行與每N分鐘執(zhí)行最基礎(chǔ)的場(chǎng)景每天凌晨2點(diǎn)執(zhí)行數(shù)據(jù)備份在Spring里這樣寫(xiě)六位格式0 0 2 * * ?含義是秒為0、分為0、時(shí)為2、每天、每月、不指定周幾。如果用的是Linux crontab則去掉秒字段寫(xiě)成0 2 * * *。每5分鐘執(zhí)行一次健康檢查Quartz里寫(xiě)0 */5 * * * ?表示“每隔5分鐘的第0秒觸發(fā)”。如果要求“每5分鐘的第30秒觸發(fā)”就只能用30 */5 * * * ?因?yàn)槊胱侄慰刂频氖恰霸谶@一分鐘的第幾秒觸發(fā)”而不是“每5分鐘執(zhí)行一次”里的起始偏移。很多人在這一步栽跟頭以為“*/5”里的“5”從執(zhí)行那一刻開(kāi)始計(jì)時(shí)其實(shí)Cron表達(dá)式天然是“對(duì)齊自然時(shí)間單位”的它不具備“相對(duì)啟動(dòng)時(shí)間”的偏移能力。4.2 工作日定時(shí)與周末排除處理“每周一到周五的上午9點(diǎn)執(zhí)行”時(shí)可以用0 0 9 ? * MON-FRI。這里的“?”用在“日”字段周字段明確寫(xiě)了“MON-FRI”。如果把表達(dá)式寫(xiě)成0 0 9 * * MON-FRI在Quartz里會(huì)解析失敗因?yàn)椤叭铡弊侄尾荒芡瑫r(shí)寫(xiě)“*”和指定周幾。在Linux crontab里則沒(méi)有這個(gè)問(wèn)題因?yàn)樗挥形鍌€(gè)字段日和周天然沖突時(shí)才需要特殊處理Linux的做法是“兩個(gè)條件同時(shí)成立才會(huì)執(zhí)行”而不是“有一個(gè)成立就行”。周末排除的另一個(gè)思路是在“周”字段明確寫(xiě)“SAT,SUN”并在任務(wù)入口做判斷但這屬于應(yīng)用層邏輯和表達(dá)式本身無(wú)關(guān)。能用表達(dá)式表達(dá)的盡量不要帶到代碼里判斷因?yàn)榉植际江h(huán)境下多實(shí)例部署時(shí)每個(gè)實(shí)例的時(shí)間零點(diǎn)不一定完全同步表達(dá)式層面統(tǒng)一控制更可靠。4.3 每月、每季度的邊界場(chǎng)景“每月1號(hào)0點(diǎn)執(zhí)行”寫(xiě)0 0 0 1 * ?很直接?！懊考径鹊谝粋€(gè)月的1號(hào)執(zhí)行”則可以寫(xiě)成0 0 0 1 1,4,7,10 *把月份枚舉出來(lái)。如果你所在業(yè)務(wù)用的是財(cái)務(wù)季度不以自然月為邊界就需要額外計(jì)算但Cron本身不支持“第幾周的周三”這種結(jié)合月份重復(fù)的模式只能用“周”字段的“#”或“L”來(lái)盡可能逼近。這里分享一個(gè)經(jīng)驗(yàn)與其費(fèi)勁寫(xiě)一條極復(fù)雜的表達(dá)式不如拆成多條簡(jiǎn)單規(guī)則例如“每月1號(hào)和16號(hào)各跑一次”邏輯清晰、后續(xù)維護(hù)也方便。我踩過(guò)一個(gè)很隱蔽的坑某個(gè)報(bào)表任務(wù)寫(xiě)的是0 0 6 1 * ?想表示“每月1號(hào)早上6點(diǎn)跑”但某月1號(hào)正好是周六任務(wù)沒(méi)跑。排查半天才發(fā)現(xiàn)表達(dá)式在“日”里寫(xiě)了“1”在“周”里寫(xiě)了“?”這意味著“每個(gè)月1號(hào)不關(guān)心周幾”?？此茮](méi)問(wèn)題但那套自研調(diào)度框架對(duì)“周”字段的“?”支持不完整把它當(dāng)成了普通值“1”即周日處理。所以一定要先在目標(biāo)系統(tǒng)里做驗(yàn)證而不是想當(dāng)然地套標(biāo)準(zhǔn)。4.4 夏令時(shí)相關(guān)很少人提、卻很重要在Quartz和Linux cron里如果服務(wù)器配置了夏令時(shí)那“每天2點(diǎn)執(zhí)行”這條規(guī)則在春季切夏令時(shí)的那一天可能直接跳過(guò)2點(diǎn)不存在在秋季切回時(shí)則可能執(zhí)行兩次。這個(gè)問(wèn)題的惡心之處在于它一年只會(huì)出現(xiàn)一兩次很多團(tuán)隊(duì)測(cè)不出來(lái)一旦上線就在特定日期出故障。我的建議是對(duì)時(shí)間精準(zhǔn)度要求高的任務(wù)盡量使用UTC時(shí)區(qū)調(diào)度如果業(yè)務(wù)強(qiáng)依賴(lài)本地時(shí)間至少要做“冪等處理”并在任務(wù)日志里打印足夠的上下文。5. 常見(jiàn)問(wèn)題與排查技巧從實(shí)測(cè)中積累的經(jīng)驗(yàn)5.1 表達(dá)式看似沒(méi)問(wèn)題任務(wù)為什么不觸發(fā)這是被問(wèn)得最多的一個(gè)問(wèn)題。第一步先確認(rèn)當(dāng)前Cron表達(dá)式框架是“六位”還是“五位”。以前我在項(xiàng)目里看到過(guò)0 2 * * *這種寫(xiě)法在Linux crontab里是合法的每天2點(diǎn)整但如果放在Quartz里第一個(gè)“0”會(huì)被當(dāng)成秒第二個(gè)“2”會(huì)被當(dāng)成分第三個(gè)“*”會(huì)被當(dāng)成時(shí)這樣解析出來(lái)的含義完全變了變成“每秒執(zhí)行一次但分固定為2、時(shí)任意”——任務(wù)瘋狂觸發(fā)日志里刷出一堆請(qǐng)求。如果在Quartz里寫(xiě)“0 2 * * *”真實(shí)的執(zhí)行頻率是每分鐘的第2秒遠(yuǎn)不是“每天2點(diǎn)”。第二步檢查時(shí)區(qū)配置。Quartz和Spring的Scheduled默認(rèn)使用服務(wù)器的本地時(shí)區(qū)而Linux crontab同樣基于系統(tǒng)時(shí)區(qū)。一旦服務(wù)器切換時(shí)區(qū)比如從Asia/Shanghai改到UTC所有定時(shí)任務(wù)都會(huì)整體偏移8小時(shí)。這種問(wèn)題很難通過(guò)看表達(dá)式發(fā)現(xiàn)所以排查到“時(shí)間對(duì)不上”的時(shí)候先看一眼環(huán)境變量。第三步看“日”和“周”是否互斥。寫(xiě)任務(wù)時(shí)如果兩個(gè)字段都有實(shí)際值一個(gè)不為?一個(gè)不為*Quartz會(huì)強(qiáng)行要求互斥否則拋異常但某些國(guó)產(chǎn)調(diào)度平臺(tái)或者基于MySQL的自研任務(wù)表可能既不校驗(yàn)也不提示而是采用“與”邏輯把兩個(gè)條件拼在一起最終結(jié)果就是“既滿(mǎn)足日期又滿(mǎn)足周幾”的全部天數(shù)里去執(zhí)行。這種情況尤其需要對(duì)表達(dá)式語(yǔ)義有完整的認(rèn)識(shí)。5.2 用在線工具校驗(yàn)對(duì)了一半另一半必須自己驗(yàn)證網(wǎng)上有很多Cron表達(dá)式在線解析器粘貼表達(dá)式就能告訴你“下一次執(zhí)行時(shí)間”。這類(lèi)工具我平時(shí)也用但只把它們當(dāng)作第一道檢查絕不當(dāng)作最終結(jié)論。原因很簡(jiǎn)單不同的在線工具實(shí)現(xiàn)標(biāo)準(zhǔn)也不統(tǒng)一有的完全仿Quartz有的只支持Linux crontab有的甚至把“?”當(dāng)“*”處理。我見(jiàn)過(guò)一個(gè)在線工具輸入0 0 12 * * ?后直接報(bào)錯(cuò)“field value must be a number”因?yàn)樗緵](méi)有實(shí)現(xiàn)“?”邏輯。真到了生產(chǎn)環(huán)境它報(bào)錯(cuò)不報(bào)錯(cuò)都說(shuō)不準(zhǔn)所以務(wù)必以你實(shí)際使用的庫(kù)源碼為準(zhǔn)。更可靠的方式是寫(xiě)一個(gè)簡(jiǎn)單的Java或者Python測(cè)試用例調(diào)用本地庫(kù)的解析器算未來(lái)5次觸發(fā)時(shí)間比對(duì)是否符合預(yù)期。以Spring為例本地寫(xiě)個(gè)main方法package com.example.demo; import org.springframework.scheduling.support.CronExpression; import java.time.LocalDateTime; public class CronCheck { public static void main(String[] args) { String expr 0 0 9 ? * MON-FRI; CronExpression cron CronExpression.parse(expr); LocalDateTime now LocalDateTime.now(); for (int i 0; i 5; i) { now cron.next(now); System.out.println(下次執(zhí)行時(shí)間: now); } } }Python環(huán)境里也有類(lèi)似的庫(kù)比如基于croniterfrom croniter import croniter from datetime import datetime base datetime.now() cron croniter(0 0 9 * * 1-5, base) for i in range(5): print(cron.get_next(datetime))這兩種方式都比在線工具靠譜因?yàn)樗鼈冇玫慕馕鲆媾c生產(chǎn)環(huán)境一致結(jié)果不會(huì)有環(huán)境差異。唯一要注意的是Quartz與Spring的Cron實(shí)現(xiàn)細(xì)節(jié)略有差異Spring實(shí)現(xiàn)不支持“年”字段所以生產(chǎn)用什么測(cè)試就用什么。5.3 凌晨不執(zhí)行延遲到上午才跑怎么回事這類(lèi)問(wèn)題大多出在“任務(wù)排程線程池被占滿(mǎn)”。定時(shí)任務(wù)到了觸發(fā)點(diǎn)調(diào)度線程把任務(wù)丟進(jìn)執(zhí)行業(yè)務(wù)線程池但線程池里的線程全都被卡住了比如數(shù)據(jù)庫(kù)連接池被打滿(mǎn)、外部HTTP調(diào)用超時(shí)任務(wù)自然延后。檢查手段主要有三步看線程池的活躍線程數(shù)、看任務(wù)隊(duì)列積壓數(shù)量、看慢調(diào)用日志。優(yōu)先排查是不是有某個(gè)任務(wù)的SQL長(zhǎng)時(shí)間鎖表把其他定時(shí)任務(wù)全堵住了。這類(lèi)問(wèn)題不是表達(dá)式錯(cuò)誤但會(huì)讓表達(dá)式“看起來(lái)像沒(méi)生效”。解決方式通常是把不同重要程度的任務(wù)拆分線程池或者給執(zhí)行時(shí)間長(zhǎng)的任務(wù)單獨(dú)隔離資源。5.4 參數(shù)化星期、月份的邊界2月29日和31日Cron表達(dá)式用“日”字段寫(xiě)“29”或“30”時(shí)在月份沒(méi)有對(duì)應(yīng)日期的自然不會(huì)觸發(fā)。比如0 0 8 31 * ?只有31天的大月才跑2月直接跳過(guò)。這符合預(yù)期但如果業(yè)務(wù)要求“每個(gè)月最后一天執(zhí)行”就不該寫(xiě)死“31”而是用“L”。寫(xiě)“L”時(shí)還要注意Quartz里的“L”作用于日字段時(shí)表示“自然月的最后一天”但如果你同時(shí)指定了周的偏移比如“5L”它的語(yǔ)義會(huì)變成“該月最后一個(gè)星期五”這兩種含義差異極大。關(guān)于2月29日Cron本身沒(méi)有“閏年判斷”能力它只按照月份天數(shù)來(lái)匹配。想表達(dá)“每年2月29日?qǐng)?zhí)行一次”直接寫(xiě)日期在第3年的2月29日才會(huì)觸發(fā)閏年這是符合語(yǔ)法但業(yè)務(wù)上通常不期望的情況。遇到這種需求我的處理方式是不要試圖用Cron描述改成“每年3月1日?qǐng)?zhí)行一次補(bǔ)償上一年閏年邏輯”或者“每年2月最后一天執(zhí)行”在業(yè)務(wù)代碼里判斷是否閏年。5.5 手動(dòng)觸發(fā)沒(méi)事、自動(dòng)執(zhí)行就報(bào)錯(cuò)常見(jiàn)的兩類(lèi)根因第一類(lèi)是表達(dá)式觸發(fā)的時(shí)刻正好是系統(tǒng)負(fù)載高峰比如所有任務(wù)都堆在“0 0 0 * * ?”這一瞬間數(shù)據(jù)庫(kù)連接瞬間被打滿(mǎn)。解決辦法是錯(cuò)峰配置把任務(wù)散到0點(diǎn)5分、0點(diǎn)10分、0點(diǎn)15分等。這也是為什么很多調(diào)度規(guī)范里明確要求“整點(diǎn)任務(wù)必須加隨機(jī)偏移”。第二類(lèi)是任務(wù)執(zhí)行時(shí)依賴(lài)外部接口而外部接口只在工作時(shí)間開(kāi)放定時(shí)任務(wù)在凌晨執(zhí)行時(shí)權(quán)限不足或接口不通。這類(lèi)問(wèn)題要靠日志定位表達(dá)式本身沒(méi)有坑坑在業(yè)務(wù)邏輯里。排查這類(lèi)問(wèn)題時(shí)要對(duì)執(zhí)行上下文比如用戶(hù)會(huì)話(huà)、token仔細(xì)檢查別讓任務(wù)跑在了一個(gè)默認(rèn)身份下。6. 設(shè)計(jì)與維護(hù)建議Cron表達(dá)式容易忽略的四個(gè)細(xì)節(jié)6.1 不要在一個(gè)表達(dá)式里堆太多語(yǔ)義一個(gè)復(fù)雜的表達(dá)式雖然能完成多個(gè)條件的組合但可讀性和可維護(hù)性都會(huì)下降。舉個(gè)例子0 5 4 1,15 * ?表示“每月1號(hào)和15號(hào)的凌晨4點(diǎn)5分執(zhí)行”這個(gè)能看懂。但如果把多個(gè)業(yè)務(wù)模塊的執(zhí)行時(shí)間全揉進(jìn)一個(gè)表達(dá)式比如“每月第一個(gè)工作日、每周三、每月最后一天”后續(xù)維護(hù)的人看到這行要么改了A業(yè)務(wù)影響B(tài)業(yè)務(wù)要么完全不敢動(dòng)。我的習(xí)慣是一個(gè)任務(wù)只描述一個(gè)明確的時(shí)間點(diǎn)或周期不合并多個(gè)業(yè)務(wù)意圖。6.2 表達(dá)式的可觀測(cè)性日志里要能看到原始配置線上排查定時(shí)任務(wù)問(wèn)題時(shí)最怕的就是配置文件里的表達(dá)式和實(shí)際運(yùn)行時(shí)的表達(dá)式不一致。比如配置中心修改了某個(gè)任務(wù)的執(zhí)行頻率但應(yīng)用沒(méi)有及時(shí)刷新。因此在任務(wù)啟動(dòng)或配置刷新時(shí)把當(dāng)前生效的表達(dá)式打印到日志里甚至把計(jì)算出的未來(lái)幾次執(zhí)行時(shí)間一并打印這樣下次再有人問(wèn)“任務(wù)怎么沒(méi)跑”直接看日志就夠了。這套小機(jī)制看起來(lái)不起眼實(shí)際能省去非常多溝通成本。6.3 任務(wù)執(zhí)行時(shí)間預(yù)估給自己留出緩沖表達(dá)式只能描述“什么時(shí)候開(kāi)始執(zhí)行”但它描述不了執(zhí)行時(shí)長(zhǎng)。這帶來(lái)兩個(gè)問(wèn)題一是重疊執(zhí)行——任務(wù)還沒(méi)跑完下一個(gè)觸發(fā)點(diǎn)已經(jīng)到了二是對(duì)后續(xù)任務(wù)的影響——比如報(bào)表任務(wù)A依賴(lài)任務(wù)B但B因?yàn)槟撤N原因延遲了A可能在“錯(cuò)誤的時(shí)間窗口”讀取了“不完整的數(shù)據(jù)”。解決手段通常有兩個(gè)方向一是加分布式鎖保證同一任務(wù)不會(huì)并發(fā)執(zhí)行二是在任務(wù)內(nèi)部做“執(zhí)行前置條件校驗(yàn)”比如判斷上游數(shù)據(jù)是否已就緒。這些雖然不屬于表達(dá)式本身但真正常出故障的往往是“表達(dá)式觸發(fā)后的一系列連鎖問(wèn)題”。6.4 配置管理與版本控制別把表達(dá)式散落各處大型項(xiàng)目里定時(shí)任務(wù)表達(dá)式往往散落在配置文件、數(shù)據(jù)庫(kù)、環(huán)境變量之中。想統(tǒng)計(jì)“當(dāng)前系統(tǒng)一共有多少個(gè)定時(shí)任務(wù)”“有沒(méi)有重復(fù)的觸發(fā)時(shí)間”都變得異常困難。比較好的實(shí)踐是把所有任務(wù)的名稱(chēng)、表達(dá)式、描述、負(fù)責(zé)人維護(hù)在同一張配置表里以某種“任務(wù)注冊(cè)”機(jī)制統(tǒng)一管理。表達(dá)式本身要做變更時(shí)走配置中心的發(fā)布流程并保留變更歷史。這并不復(fù)雜但對(duì)長(zhǎng)期維護(hù)有決定性的影響。6.5 生日提醒這類(lèi)“時(shí)點(diǎn)型”需求Cron天生不適合Cron的核心能力是“周期性規(guī)律觸發(fā)”它不具備“根據(jù)某條記錄的時(shí)間字段動(dòng)態(tài)計(jì)算下一次觸發(fā)時(shí)間”的能力。如果你要做一個(gè)“用戶(hù)生日當(dāng)天上午10點(diǎn)發(fā)送提醒”的功能用Cron是沒(méi)法直接注冊(cè)的——因?yàn)槊總€(gè)用戶(hù)的生日不同不能為每個(gè)用戶(hù)都建一個(gè)表達(dá)式即便可以數(shù)量一多也hold不住。這種場(chǎng)景更合理的設(shè)計(jì)是每天早上用一條Cron任務(wù)跑一次掃描篩出當(dāng)天過(guò)生日的用戶(hù)再逐條發(fā)送消息。理解這一點(diǎn)能幫你在規(guī)劃架構(gòu)時(shí)少走彎路Cron做“節(jié)奏”不負(fù)責(zé)“精準(zhǔn)到每個(gè)個(gè)體”。最后分享一點(diǎn)個(gè)人體會(huì)做調(diào)度系統(tǒng)這幾年我對(duì)Cron表達(dá)式的最大感受是它的門(mén)檻不高門(mén)檻在于“你以為自己會(huì)了”。很多初學(xué)時(shí)踩的坑回頭去看都是因?yàn)闆](méi)把字段之間的約束關(guān)系當(dāng)成一回事。線上環(huán)境里表達(dá)式的錯(cuò)誤往往不會(huì)以“拋出異?！钡男问匠尸F(xiàn)而是以“讓人摸不著頭腦的不執(zhí)行”方式出現(xiàn)這種問(wèn)題排查起來(lái)特別費(fèi)力。所以我現(xiàn)在給自己定的規(guī)矩是三條新寫(xiě)的表達(dá)式一定先用庫(kù)解析器算三步未來(lái)時(shí)間涉及“日”和“周”的表達(dá)式一定要刻意提醒自己檢查互斥關(guān)系任務(wù)的執(zhí)行和配置一定有日志留痕。這套習(xí)慣說(shuō)不上多高深但確實(shí)把我從不少凌晨三點(diǎn)的告警郵件里撈了出來(lái)。希望這篇關(guān)于Cron的梳理也能幫你避開(kāi)我當(dāng)年踩過(guò)的那些坑。 徹底搞懂Cron表達(dá)式：字段規(guī)則、特殊字符與定時(shí)任務(wù)實(shí)戰(zhàn)指南
1. 從理解到上手先把Cron表達(dá)式的底摸清定時(shí)任務(wù)大概是后臺(tái)開(kāi)發(fā)里最“日?！眳s又最容易被忽視的東西。你可能見(jiàn)過(guò)這樣的場(chǎng)景運(yùn)維同學(xué)半夜收到告警郵件上去一看是某個(gè)統(tǒng)計(jì)腳本沒(méi)跑開(kāi)發(fā)同學(xué)說(shuō)“我明明配了每天零點(diǎn)執(zhí)行”結(jié)果任務(wù)完全沒(méi)觸發(fā)還有更常見(jiàn)的——表達(dá)式寫(xiě)錯(cuò)導(dǎo)致任務(wù)在凌晨三點(diǎn)重復(fù)執(zhí)行數(shù)據(jù)庫(kù)被瞬時(shí)壓力打滿(mǎn)。這些事我基本都踩過(guò)一遍追到根上多數(shù)時(shí)候就是Cron表達(dá)式寫(xiě)得不嚴(yán)謹(jǐn)。Cron表達(dá)式本質(zhì)上就是一套用來(lái)描述“周期性時(shí)間點(diǎn)”的規(guī)則語(yǔ)言。很多人在初次接觸時(shí)只背了個(gè)七位格式覺(jué)得無(wú)非是“秒 分 時(shí) 日 月 周”真到了要寫(xiě)一個(gè)“每個(gè)工作日的上午9點(diǎn)半跑一次”的表達(dá)式時(shí)卻卡在了“?”和“*”的區(qū)別上。這篇內(nèi)容不搞教科書(shū)式的羅列而是從“為什么這樣設(shè)計(jì)”出發(fā)把字段規(guī)則、特殊字符、實(shí)際案例和踩坑經(jīng)驗(yàn)一并講透希望能幫你徹底掌握這一小塊卻極其關(guān)鍵的技能點(diǎn)。這套規(guī)則適用于哪些場(chǎng)景最典型的就是定時(shí)任務(wù)調(diào)度Java的Quartz框架、Spring的Scheduled注解、Linux系統(tǒng)的crontab命令、大數(shù)據(jù)平臺(tái)里的調(diào)度系統(tǒng)以及各類(lèi)數(shù)據(jù)同步、日志清理、報(bào)表生成任務(wù)。適合哪些人看如果你正在維護(hù)帶定時(shí)任務(wù)的系統(tǒng)、平時(shí)要寫(xiě)計(jì)劃任務(wù)腳本或者單純想弄明白“0 0 3 * * ?”到底怎么讀這篇文章都能給你實(shí)在的參考。2. 核心設(shè)計(jì)拆解Cron表達(dá)式為什么長(zhǎng)這樣2.1 煩瑣背后的邏輯為什么需要7個(gè)字段很多人剛接觸Cron時(shí)最不適應(yīng)的地方是它比常見(jiàn)的“5字段”格式多出了“秒”字段。某些系統(tǒng)里寫(xiě)“0 0 12 * * ?”是六位而在帶秒的場(chǎng)景下要寫(xiě)“0 0 12 * * ?”是六位而在Quartz里必須寫(xiě)成“0 0 12 * * ?”。傳統(tǒng)Linux crontab只有五位數(shù)分 時(shí) 日 月 周它不支持秒級(jí)精度。但Quartz這類(lèi)框架在設(shè)計(jì)時(shí)發(fā)現(xiàn)很多業(yè)務(wù)場(chǎng)景需要秒級(jí)別的觸發(fā)比如“每10秒刷新一次緩存”。于是它把字段擴(kuò)成了“秒 分 時(shí) 日 月 周 年可省略”。這也解釋了為什么網(wǎng)上經(jīng)常出現(xiàn)六位和七位混用的情況——大家用的SDK不同底層結(jié)構(gòu)就不一樣。自己寫(xiě)調(diào)度代碼時(shí)第一件事永遠(yuǎn)是確認(rèn)當(dāng)前用的是什么庫(kù)然后再談表達(dá)式怎么寫(xiě)。2.2 六位和七位少一個(gè)字段意味著什么有些框架比如Spring早期版本支持六位格式秒 分 時(shí) 日 月 周。七位格式則是在末尾加了“年”字段變成秒 分 時(shí) 日 月 周 年。年在絕大多數(shù)系統(tǒng)里用不到通常寫(xiě)成“*”或直接省略。如果某個(gè)調(diào)度器不支持年份字段你卻硬寫(xiě)了七位大概率會(huì)直接拋異常。你可以這樣理解六位和七位的關(guān)系就像“日期時(shí)間”和“日期時(shí)間年份”的關(guān)系。如果你只需要“每年6月1日?qǐng)?zhí)行”這種任務(wù)年份字段才有存在價(jià)值但實(shí)際業(yè)務(wù)里這類(lèi)需求很少更多是“每天”“每周幾”“每月幾號(hào)”這類(lèi)循環(huán)模式。所以我的經(jīng)驗(yàn)是優(yōu)先用六位別給自己找麻煩。2.3 每一位的取值邊界先搞懂才能談優(yōu)化Cron表達(dá)式拆開(kāi)后每一位的取值范圍和含義如下字段是否必填取值范圍允許的特殊字符秒是0-59, - * /分是0-59, - * /時(shí)是0-23, - * /日是1-31, - * ? / L W月是1-12 或 JAN-DEC, - * /周是1-7 或 SUN-SAT, - * ? / L #年可選否1970-2099, - * /這里必須強(qiáng)調(diào)一個(gè)高頻錯(cuò)誤日和周兩個(gè)字段是互斥的。如果你在“日”里寫(xiě)了具體的天數(shù)比如“15”那“周”就必須用“?”占位反過(guò)來(lái)也一樣。因?yàn)橄到y(tǒng)沒(méi)法同時(shí)判斷“每月15號(hào)”和“每周一”——這兩個(gè)條件同時(shí)生效時(shí)任務(wù)會(huì)在哪個(gè)點(diǎn)跑完全無(wú)法預(yù)測(cè)。這就是為什么“?”這個(gè)特殊字符在Cron表達(dá)式里有不可替代的地位。3. 特殊字符全解析從星號(hào)到問(wèn)號(hào)逐個(gè)擊破3.1 * 與 ?一對(duì)最容易混的兄弟“”在Cron里表示“任意值”相當(dāng)于通配符。舉個(gè)例子在“分”字段寫(xiě)“”意味著每分鐘都觸發(fā)在“時(shí)”字段寫(xiě)“*”意味著每小時(shí)都觸發(fā)?！?”的語(yǔ)義則完全不同它只用于“日”和“周”兩個(gè)字段表示“不指定值”。為什么需要這種語(yǔ)義正因?yàn)槿蘸椭芑コ猱?dāng)你設(shè)置了“日”字段時(shí)“周”就必須明確告訴系統(tǒng)“我不關(guān)心周幾”而這個(gè)“我不關(guān)心”就得用“?”來(lái)表達(dá)。我遇到過(guò)不少這樣的失誤在Spring的Scheduled注解里寫(xiě)“0 0 12 15 *”結(jié)果任務(wù)沒(méi)觸發(fā)日志里也沒(méi)有任何報(bào)錯(cuò)。原因就是“日”里寫(xiě)了15“周”里卻寫(xiě)了“”系統(tǒng)解析時(shí)把兩個(gè)條件同時(shí)生效了15號(hào)可能不是周一而周一可能不是15號(hào)條件疊加最終導(dǎo)致不匹配。正確寫(xiě)法是“0 0 12 15 * ?”。3.2 - 與 /范圍與步長(zhǎng)的聯(lián)合作戰(zhàn)“-”表示一個(gè)連續(xù)范圍。比如“小時(shí)”字段寫(xiě)“9-18”代表從上午9點(diǎn)到下午6點(diǎn)之間每個(gè)整點(diǎn)都觸發(fā)配合“分”字段的“0”就是“每天9點(diǎn)到18點(diǎn)的每分鐘或每小時(shí)整點(diǎn)執(zhí)行”。“/”表示步長(zhǎng)?！?/5”表示每隔5個(gè)單位執(zhí)行一次“0/15”表示從0開(kāi)始每隔15個(gè)單位執(zhí)行一次。這兩個(gè)字符合起來(lái)能完成很多常見(jiàn)配置。比如“每工作日的上午9點(diǎn)到下午6點(diǎn)之間每隔30分鐘執(zhí)行一次”可以寫(xiě)成“0 0/30 9-18 * * MON-FRI”。拆開(kāi)看秒位“0”表示整秒觸發(fā)分位“0/30”是從0分開(kāi)始每30分鐘一次時(shí)位“9-18”限制了小時(shí)范圍周位“MON-FRI”限制了工作日。這套組合在數(shù)據(jù)統(tǒng)計(jì)類(lèi)的定時(shí)任務(wù)里非常常見(jiàn)。3.3 L、W、#復(fù)雜日期需求的三件兵器“L”代表“最后一天”在不同字段里有不同含義在“日”字段表示月份的最后一天比如1月31日、4月30日在“周”字段單獨(dú)使用表示“星期六”即每周的最后一天跟在數(shù)字后面則代表“該月最后一個(gè)星期幾”比如“5L”表示該月最后一個(gè)星期五?！癢”代表“最近的工作日”只能用在“日”字段。比如“15W”表示“離15號(hào)最近的那個(gè)工作日”。如果15號(hào)是周六則觸發(fā)在周五14號(hào)如果15號(hào)是周日則觸發(fā)在周一16號(hào)。這個(gè)設(shè)計(jì)對(duì)“每月中旬的工作日?qǐng)?zhí)行賬務(wù)處理”這類(lèi)的業(yè)務(wù)非常有用?！?”則是“第幾個(gè)星期幾”只能用在“周”字段“6#3”表示“該月第三個(gè)星期五”按國(guó)外習(xí)慣周日是第一天6對(duì)應(yīng)周五。這三件兵器解決的都是“自然語(yǔ)言里的模糊時(shí)間描述”問(wèn)題。但如果系統(tǒng)本身沒(méi)有實(shí)現(xiàn)這些標(biāo)準(zhǔn)部分自研調(diào)度框架只支持基礎(chǔ)的五位格式你用了L、W、#反而會(huì)直接報(bào)錯(cuò)。所以用之前務(wù)必確認(rèn)框架的文檔。3.4 星期與月份的英文縮寫(xiě)寫(xiě)錯(cuò)一個(gè)字母排查半天Cron允許在月和周的字段使用英文縮寫(xiě)JAN-DEC對(duì)應(yīng)1-12月SUN-SAT對(duì)應(yīng)周日到周六。這里有一個(gè)容易混淆的點(diǎn)在Linux的crontab里周的數(shù)字“0”和“7”都表示周日有的系統(tǒng)把“7”也當(dāng)作周日但在Quartz里周的數(shù)字范圍是“1-7”其中“1”代表周日“7”代表周六。這兩種體系的語(yǔ)義正好錯(cuò)位如果從網(wǎng)上抄一個(gè)表達(dá)式時(shí)沒(méi)注意來(lái)源很容易翻車(chē)。我習(xí)慣的做法是無(wú)論是自己寫(xiě)還是審查別人的表達(dá)式一律使用英文縮寫(xiě)來(lái)標(biāo)記星期比如“MON-FRI”而不是“1-5”。這樣不僅可讀性強(qiáng)還能避免Quartz與Linux體系數(shù)字語(yǔ)義不一致的暗坑。4. 實(shí)操環(huán)節(jié)那些直接抄作業(yè)就能用的表達(dá)式4.1 每天定點(diǎn)執(zhí)行與每N分鐘執(zhí)行最基礎(chǔ)的場(chǎng)景每天凌晨2點(diǎn)執(zhí)行數(shù)據(jù)備份在Spring里這樣寫(xiě)六位格式0 0 2 * * ?含義是秒為0、分為0、時(shí)為2、每天、每月、不指定周幾。如果用的是Linux crontab則去掉秒字段寫(xiě)成0 2 * * *。每5分鐘執(zhí)行一次健康檢查Quartz里寫(xiě)0 */5 * * * ?表示“每隔5分鐘的第0秒觸發(fā)”。如果要求“每5分鐘的第30秒觸發(fā)”就只能用30 */5 * * * ?因?yàn)槊胱侄慰刂频氖恰霸谶@一分鐘的第幾秒觸發(fā)”而不是“每5分鐘執(zhí)行一次”里的起始偏移。很多人在這一步栽跟頭以為“*/5”里的“5”從執(zhí)行那一刻開(kāi)始計(jì)時(shí)其實(shí)Cron表達(dá)式天然是“對(duì)齊自然時(shí)間單位”的它不具備“相對(duì)啟動(dòng)時(shí)間”的偏移能力。4.2 工作日定時(shí)與周末排除處理“每周一到周五的上午9點(diǎn)執(zhí)行”時(shí)可以用0 0 9 ? * MON-FRI。這里的“?”用在“日”字段周字段明確寫(xiě)了“MON-FRI”。如果把表達(dá)式寫(xiě)成0 0 9 * * MON-FRI在Quartz里會(huì)解析失敗因?yàn)椤叭铡弊侄尾荒芡瑫r(shí)寫(xiě)“*”和指定周幾。在Linux crontab里則沒(méi)有這個(gè)問(wèn)題因?yàn)樗挥形鍌€(gè)字段日和周天然沖突時(shí)才需要特殊處理Linux的做法是“兩個(gè)條件同時(shí)成立才會(huì)執(zhí)行”而不是“有一個(gè)成立就行”。周末排除的另一個(gè)思路是在“周”字段明確寫(xiě)“SAT,SUN”并在任務(wù)入口做判斷但這屬于應(yīng)用層邏輯和表達(dá)式本身無(wú)關(guān)。能用表達(dá)式表達(dá)的盡量不要帶到代碼里判斷因?yàn)榉植际江h(huán)境下多實(shí)例部署時(shí)每個(gè)實(shí)例的時(shí)間零點(diǎn)不一定完全同步表達(dá)式層面統(tǒng)一控制更可靠。4.3 每月、每季度的邊界場(chǎng)景“每月1號(hào)0點(diǎn)執(zhí)行”寫(xiě)0 0 0 1 * ?很直接?！懊考径鹊谝粋€(gè)月的1號(hào)執(zhí)行”則可以寫(xiě)成0 0 0 1 1,4,7,10 *把月份枚舉出來(lái)。如果你所在業(yè)務(wù)用的是財(cái)務(wù)季度不以自然月為邊界就需要額外計(jì)算但Cron本身不支持“第幾周的周三”這種結(jié)合月份重復(fù)的模式只能用“周”字段的“#”或“L”來(lái)盡可能逼近。這里分享一個(gè)經(jīng)驗(yàn)與其費(fèi)勁寫(xiě)一條極復(fù)雜的表達(dá)式不如拆成多條簡(jiǎn)單規(guī)則例如“每月1號(hào)和16號(hào)各跑一次”邏輯清晰、后續(xù)維護(hù)也方便。我踩過(guò)一個(gè)很隱蔽的坑某個(gè)報(bào)表任務(wù)寫(xiě)的是0 0 6 1 * ?想表示“每月1號(hào)早上6點(diǎn)跑”但某月1號(hào)正好是周六任務(wù)沒(méi)跑。排查半天才發(fā)現(xiàn)表達(dá)式在“日”里寫(xiě)了“1”在“周”里寫(xiě)了“?”這意味著“每個(gè)月1號(hào)不關(guān)心周幾”?？此茮](méi)問(wèn)題但那套自研調(diào)度框架對(duì)“周”字段的“?”支持不完整把它當(dāng)成了普通值“1”即周日處理。所以一定要先在目標(biāo)系統(tǒng)里做驗(yàn)證而不是想當(dāng)然地套標(biāo)準(zhǔn)。4.4 夏令時(shí)相關(guān)很少人提、卻很重要在Quartz和Linux cron里如果服務(wù)器配置了夏令時(shí)那“每天2點(diǎn)執(zhí)行”這條規(guī)則在春季切夏令時(shí)的那一天可能直接跳過(guò)2點(diǎn)不存在在秋季切回時(shí)則可能執(zhí)行兩次。這個(gè)問(wèn)題的惡心之處在于它一年只會(huì)出現(xiàn)一兩次很多團(tuán)隊(duì)測(cè)不出來(lái)一旦上線就在特定日期出故障。我的建議是對(duì)時(shí)間精準(zhǔn)度要求高的任務(wù)盡量使用UTC時(shí)區(qū)調(diào)度如果業(yè)務(wù)強(qiáng)依賴(lài)本地時(shí)間至少要做“冪等處理”并在任務(wù)日志里打印足夠的上下文。5. 常見(jiàn)問(wèn)題與排查技巧從實(shí)測(cè)中積累的經(jīng)驗(yàn)5.1 表達(dá)式看似沒(méi)問(wèn)題任務(wù)為什么不觸發(fā)這是被問(wèn)得最多的一個(gè)問(wèn)題。第一步先確認(rèn)當(dāng)前Cron表達(dá)式框架是“六位”還是“五位”。以前我在項(xiàng)目里看到過(guò)0 2 * * *這種寫(xiě)法在Linux crontab里是合法的每天2點(diǎn)整但如果放在Quartz里第一個(gè)“0”會(huì)被當(dāng)成秒第二個(gè)“2”會(huì)被當(dāng)成分第三個(gè)“*”會(huì)被當(dāng)成時(shí)這樣解析出來(lái)的含義完全變了變成“每秒執(zhí)行一次但分固定為2、時(shí)任意”——任務(wù)瘋狂觸發(fā)日志里刷出一堆請(qǐng)求。如果在Quartz里寫(xiě)“0 2 * * *”真實(shí)的執(zhí)行頻率是每分鐘的第2秒遠(yuǎn)不是“每天2點(diǎn)”。第二步檢查時(shí)區(qū)配置。Quartz和Spring的Scheduled默認(rèn)使用服務(wù)器的本地時(shí)區(qū)而Linux crontab同樣基于系統(tǒng)時(shí)區(qū)。一旦服務(wù)器切換時(shí)區(qū)比如從Asia/Shanghai改到UTC所有定時(shí)任務(wù)都會(huì)整體偏移8小時(shí)。這種問(wèn)題很難通過(guò)看表達(dá)式發(fā)現(xiàn)所以排查到“時(shí)間對(duì)不上”的時(shí)候先看一眼環(huán)境變量。第三步看“日”和“周”是否互斥。寫(xiě)任務(wù)時(shí)如果兩個(gè)字段都有實(shí)際值一個(gè)不為?一個(gè)不為*Quartz會(huì)強(qiáng)行要求互斥否則拋異常但某些國(guó)產(chǎn)調(diào)度平臺(tái)或者基于MySQL的自研任務(wù)表可能既不校驗(yàn)也不提示而是采用“與”邏輯把兩個(gè)條件拼在一起最終結(jié)果就是“既滿(mǎn)足日期又滿(mǎn)足周幾”的全部天數(shù)里去執(zhí)行。這種情況尤其需要對(duì)表達(dá)式語(yǔ)義有完整的認(rèn)識(shí)。5.2 用在線工具校驗(yàn)對(duì)了一半另一半必須自己驗(yàn)證網(wǎng)上有很多Cron表達(dá)式在線解析器粘貼表達(dá)式就能告訴你“下一次執(zhí)行時(shí)間”。這類(lèi)工具我平時(shí)也用但只把它們當(dāng)作第一道檢查絕不當(dāng)作最終結(jié)論。原因很簡(jiǎn)單不同的在線工具實(shí)現(xiàn)標(biāo)準(zhǔn)也不統(tǒng)一有的完全仿Quartz有的只支持Linux crontab有的甚至把“?”當(dāng)“*”處理。我見(jiàn)過(guò)一個(gè)在線工具輸入0 0 12 * * ?后直接報(bào)錯(cuò)“field value must be a number”因?yàn)樗緵](méi)有實(shí)現(xiàn)“?”邏輯。真到了生產(chǎn)環(huán)境它報(bào)錯(cuò)不報(bào)錯(cuò)都說(shuō)不準(zhǔn)所以務(wù)必以你實(shí)際使用的庫(kù)源碼為準(zhǔn)。更可靠的方式是寫(xiě)一個(gè)簡(jiǎn)單的Java或者Python測(cè)試用例調(diào)用本地庫(kù)的解析器算未來(lái)5次觸發(fā)時(shí)間比對(duì)是否符合預(yù)期。以Spring為例本地寫(xiě)個(gè)main方法package com.example.demo; import org.springframework.scheduling.support.CronExpression; import java.time.LocalDateTime; public class CronCheck { public static void main(String[] args) { String expr 0 0 9 ? * MON-FRI; CronExpression cron CronExpression.parse(expr); LocalDateTime now LocalDateTime.now(); for (int i 0; i 5; i) { now cron.next(now); System.out.println(下次執(zhí)行時(shí)間: now); } } }Python環(huán)境里也有類(lèi)似的庫(kù)比如基于croniterfrom croniter import croniter from datetime import datetime base datetime.now() cron croniter(0 0 9 * * 1-5, base) for i in range(5): print(cron.get_next(datetime))這兩種方式都比在線工具靠譜因?yàn)樗鼈冇玫慕馕鲆媾c生產(chǎn)環(huán)境一致結(jié)果不會(huì)有環(huán)境差異。唯一要注意的是Quartz與Spring的Cron實(shí)現(xiàn)細(xì)節(jié)略有差異Spring實(shí)現(xiàn)不支持“年”字段所以生產(chǎn)用什么測(cè)試就用什么。5.3 凌晨不執(zhí)行延遲到上午才跑怎么回事這類(lèi)問(wèn)題大多出在“任務(wù)排程線程池被占滿(mǎn)”。定時(shí)任務(wù)到了觸發(fā)點(diǎn)調(diào)度線程把任務(wù)丟進(jìn)執(zhí)行業(yè)務(wù)線程池但線程池里的線程全都被卡住了比如數(shù)據(jù)庫(kù)連接池被打滿(mǎn)、外部HTTP調(diào)用超時(shí)任務(wù)自然延后。檢查手段主要有三步看線程池的活躍線程數(shù)、看任務(wù)隊(duì)列積壓數(shù)量、看慢調(diào)用日志。優(yōu)先排查是不是有某個(gè)任務(wù)的SQL長(zhǎng)時(shí)間鎖表把其他定時(shí)任務(wù)全堵住了。這類(lèi)問(wèn)題不是表達(dá)式錯(cuò)誤但會(huì)讓表達(dá)式“看起來(lái)像沒(méi)生效”。解決方式通常是把不同重要程度的任務(wù)拆分線程池或者給執(zhí)行時(shí)間長(zhǎng)的任務(wù)單獨(dú)隔離資源。5.4 參數(shù)化星期、月份的邊界2月29日和31日Cron表達(dá)式用“日”字段寫(xiě)“29”或“30”時(shí)在月份沒(méi)有對(duì)應(yīng)日期的自然不會(huì)觸發(fā)。比如0 0 8 31 * ?只有31天的大月才跑2月直接跳過(guò)。這符合預(yù)期但如果業(yè)務(wù)要求“每個(gè)月最后一天執(zhí)行”就不該寫(xiě)死“31”而是用“L”。寫(xiě)“L”時(shí)還要注意Quartz里的“L”作用于日字段時(shí)表示“自然月的最后一天”但如果你同時(shí)指定了周的偏移比如“5L”它的語(yǔ)義會(huì)變成“該月最后一個(gè)星期五”這兩種含義差異極大。關(guān)于2月29日Cron本身沒(méi)有“閏年判斷”能力它只按照月份天數(shù)來(lái)匹配。想表達(dá)“每年2月29日?qǐng)?zhí)行一次”直接寫(xiě)日期在第3年的2月29日才會(huì)觸發(fā)閏年這是符合語(yǔ)法但業(yè)務(wù)上通常不期望的情況。遇到這種需求我的處理方式是不要試圖用Cron描述改成“每年3月1日?qǐng)?zhí)行一次補(bǔ)償上一年閏年邏輯”或者“每年2月最后一天執(zhí)行”在業(yè)務(wù)代碼里判斷是否閏年。5.5 手動(dòng)觸發(fā)沒(méi)事、自動(dòng)執(zhí)行就報(bào)錯(cuò)常見(jiàn)的兩類(lèi)根因第一類(lèi)是表達(dá)式觸發(fā)的時(shí)刻正好是系統(tǒng)負(fù)載高峰比如所有任務(wù)都堆在“0 0 0 * * ?”這一瞬間數(shù)據(jù)庫(kù)連接瞬間被打滿(mǎn)。解決辦法是錯(cuò)峰配置把任務(wù)散到0點(diǎn)5分、0點(diǎn)10分、0點(diǎn)15分等。這也是為什么很多調(diào)度規(guī)范里明確要求“整點(diǎn)任務(wù)必須加隨機(jī)偏移”。第二類(lèi)是任務(wù)執(zhí)行時(shí)依賴(lài)外部接口而外部接口只在工作時(shí)間開(kāi)放定時(shí)任務(wù)在凌晨執(zhí)行時(shí)權(quán)限不足或接口不通。這類(lèi)問(wèn)題要靠日志定位表達(dá)式本身沒(méi)有坑坑在業(yè)務(wù)邏輯里。排查這類(lèi)問(wèn)題時(shí)要對(duì)執(zhí)行上下文比如用戶(hù)會(huì)話(huà)、token仔細(xì)檢查別讓任務(wù)跑在了一個(gè)默認(rèn)身份下。6. 設(shè)計(jì)與維護(hù)建議Cron表達(dá)式容易忽略的四個(gè)細(xì)節(jié)6.1 不要在一個(gè)表達(dá)式里堆太多語(yǔ)義一個(gè)復(fù)雜的表達(dá)式雖然能完成多個(gè)條件的組合但可讀性和可維護(hù)性都會(huì)下降。舉個(gè)例子0 5 4 1,15 * ?表示“每月1號(hào)和15號(hào)的凌晨4點(diǎn)5分執(zhí)行”這個(gè)能看懂。但如果把多個(gè)業(yè)務(wù)模塊的執(zhí)行時(shí)間全揉進(jìn)一個(gè)表達(dá)式比如“每月第一個(gè)工作日、每周三、每月最后一天”后續(xù)維護(hù)的人看到這行要么改了A業(yè)務(wù)影響B(tài)業(yè)務(wù)要么完全不敢動(dòng)。我的習(xí)慣是一個(gè)任務(wù)只描述一個(gè)明確的時(shí)間點(diǎn)或周期不合并多個(gè)業(yè)務(wù)意圖。6.2 表達(dá)式的可觀測(cè)性日志里要能看到原始配置線上排查定時(shí)任務(wù)問(wèn)題時(shí)最怕的就是配置文件里的表達(dá)式和實(shí)際運(yùn)行時(shí)的表達(dá)式不一致。比如配置中心修改了某個(gè)任務(wù)的執(zhí)行頻率但應(yīng)用沒(méi)有及時(shí)刷新。因此在任務(wù)啟動(dòng)或配置刷新時(shí)把當(dāng)前生效的表達(dá)式打印到日志里甚至把計(jì)算出的未來(lái)幾次執(zhí)行時(shí)間一并打印這樣下次再有人問(wèn)“任務(wù)怎么沒(méi)跑”直接看日志就夠了。這套小機(jī)制看起來(lái)不起眼實(shí)際能省去非常多溝通成本。6.3 任務(wù)執(zhí)行時(shí)間預(yù)估給自己留出緩沖表達(dá)式只能描述“什么時(shí)候開(kāi)始執(zhí)行”但它描述不了執(zhí)行時(shí)長(zhǎng)。這帶來(lái)兩個(gè)問(wèn)題一是重疊執(zhí)行——任務(wù)還沒(méi)跑完下一個(gè)觸發(fā)點(diǎn)已經(jīng)到了二是對(duì)后續(xù)任務(wù)的影響——比如報(bào)表任務(wù)A依賴(lài)任務(wù)B但B因?yàn)槟撤N原因延遲了A可能在“錯(cuò)誤的時(shí)間窗口”讀取了“不完整的數(shù)據(jù)”。解決手段通常有兩個(gè)方向一是加分布式鎖保證同一任務(wù)不會(huì)并發(fā)執(zhí)行二是在任務(wù)內(nèi)部做“執(zhí)行前置條件校驗(yàn)”比如判斷上游數(shù)據(jù)是否已就緒。這些雖然不屬于表達(dá)式本身但真正常出故障的往往是“表達(dá)式觸發(fā)后的一系列連鎖問(wèn)題”。6.4 配置管理與版本控制別把表達(dá)式散落各處大型項(xiàng)目里定時(shí)任務(wù)表達(dá)式往往散落在配置文件、數(shù)據(jù)庫(kù)、環(huán)境變量之中。想統(tǒng)計(jì)“當(dāng)前系統(tǒng)一共有多少個(gè)定時(shí)任務(wù)”“有沒(méi)有重復(fù)的觸發(fā)時(shí)間”都變得異常困難。比較好的實(shí)踐是把所有任務(wù)的名稱(chēng)、表達(dá)式、描述、負(fù)責(zé)人維護(hù)在同一張配置表里以某種“任務(wù)注冊(cè)”機(jī)制統(tǒng)一管理。表達(dá)式本身要做變更時(shí)走配置中心的發(fā)布流程并保留變更歷史。這并不復(fù)雜但對(duì)長(zhǎng)期維護(hù)有決定性的影響。6.5 生日提醒這類(lèi)“時(shí)點(diǎn)型”需求Cron天生不適合Cron的核心能力是“周期性規(guī)律觸發(fā)”它不具備“根據(jù)某條記錄的時(shí)間字段動(dòng)態(tài)計(jì)算下一次觸發(fā)時(shí)間”的能力。如果你要做一個(gè)“用戶(hù)生日當(dāng)天上午10點(diǎn)發(fā)送提醒”的功能用Cron是沒(méi)法直接注冊(cè)的——因?yàn)槊總€(gè)用戶(hù)的生日不同不能為每個(gè)用戶(hù)都建一個(gè)表達(dá)式即便可以數(shù)量一多也hold不住。這種場(chǎng)景更合理的設(shè)計(jì)是每天早上用一條Cron任務(wù)跑一次掃描篩出當(dāng)天過(guò)生日的用戶(hù)再逐條發(fā)送消息。理解這一點(diǎn)能幫你在規(guī)劃架構(gòu)時(shí)少走彎路Cron做“節(jié)奏”不負(fù)責(zé)“精準(zhǔn)到每個(gè)個(gè)體”。最后分享一點(diǎn)個(gè)人體會(huì)做調(diào)度系統(tǒng)這幾年我對(duì)Cron表達(dá)式的最大感受是它的門(mén)檻不高門(mén)檻在于“你以為自己會(huì)了”。很多初學(xué)時(shí)踩的坑回頭去看都是因?yàn)闆](méi)把字段之間的約束關(guān)系當(dāng)成一回事。線上環(huán)境里表達(dá)式的錯(cuò)誤往往不會(huì)以“拋出異?！钡男问匠尸F(xiàn)而是以“讓人摸不著頭腦的不執(zhí)行”方式出現(xiàn)這種問(wèn)題排查起來(lái)特別費(fèi)力。所以我現(xiàn)在給自己定的規(guī)矩是三條新寫(xiě)的表達(dá)式一定先用庫(kù)解析器算三步未來(lái)時(shí)間涉及“日”和“周”的表達(dá)式一定要刻意提醒自己檢查互斥關(guān)系任務(wù)的執(zhí)行和配置一定有日志留痕。這套習(xí)慣說(shuō)不上多高深但確實(shí)把我從不少凌晨三點(diǎn)的告警郵件里撈了出來(lái)。希望這篇關(guān)于Cron的梳理也能幫你避開(kāi)我當(dāng)年踩過(guò)的那些坑。