Linux 与服务器运维 / 知识点
Cron 定时任务语法速查
快捷表达式
@reboot 表示 Cron 守护进程启动后执行一次任务,常用于启动脚本;它不等于系统完成所有网络和依赖服务初始化后再执行。
@reboot 开机后执行
@reboot 用于让任务在 Cron 守护进程启动后执行一次,适合启动初始化、临时文件准备等任务。它只保证触发时机与 Cron 启动相关,不保证网络、数据库或其他系统服务已经就绪。
怎么判读
| 线索 | 含义 | 建议动作 |
|---|---|---|
@reboot |
Cron 启动后运行一次 | 用于无需固定时刻的启动任务 |
| 任务依赖网络或数据库 | Cron 触发时依赖服务可能尚未可用 | 在脚本中主动等待或重试依赖 |
| 重启 Cron 服务后再次执行 | 某些实现把守护进程启动视为 @reboot 触发点 |
不要把它理解为严格的“整机只执行一次” |
配置与确认
以下配置适用于当前用户通过 crontab -e 管理的 crontab:
@reboot date >> /tmp/cron-reboot.log保存后可确认条目是否已经安装:
crontab -l | grep -F '@reboot date >> /tmp/cron-reboot.log'预期输出:
@reboot date >> /tmp/cron-reboot.log系统或 Cron 服务经历下一次相应启动后,可以检查任务是否实际执行:
test -s /tmp/cron-reboot.log && echo 'reboot cron ran'预期输出:
reboot cron ran适用范围
@reboot 属于常见 Cron 扩展快捷表达式,但具体触发语义取决于 Cron 实现和系统启动方式。对于必须等待网络、挂载点或其他服务就绪的任务,应在被调用脚本中增加明确的就绪检查;需要严格服务依赖关系时,系统服务管理器通常比单纯依赖 @reboot 更合适。
@hourly 通常等价于每小时执行一次,常用于替代 0 * * * *;是否支持这些快捷表达式取决于具体 Cron 实现。
@hourly 每小时执行
@hourly 是常见 Cron 快捷表达式,用于每小时执行一次任务。在支持该语法的实现中,它通常等价于五字段表达式 0 * * * *,也就是每个小时的第 0 分钟触发。
怎么判读
| 写法 | 含义 | 建议动作 |
|---|---|---|
@hourly |
每小时执行一次 | 适合希望突出执行周期的配置 |
0 * * * * |
每小时第 0 分钟执行 | 需要兼容不支持快捷表达式的实现时使用 |
| 一小时内需要多次执行 | @hourly 无法表达分钟级频率 |
改用标准五字段 Cron 表达式 |
配置与确认
以下配置适用于当前用户通过 crontab -e 管理的 crontab:
@hourly date >> /tmp/cron-test.log保存后先确认条目已经安装:
crontab -l | grep -F '@hourly date >> /tmp/cron-test.log'预期输出:
@hourly date >> /tmp/cron-test.log等待下一次小时边界触发后,可检查日志文件是否已经产生内容:
test -s /tmp/cron-test.log && echo 'hourly cron ran'预期输出:
hourly cron ran适用范围
@hourly 并非所有 Cron 实现都必须支持。迁移到不同系统或精简版 Cron 实现时,应先检查对应的 crontab 文档;不确定时使用标准五字段写法 0 * * * * 通常更容易明确表达调度时间。
@daily 通常表示每天执行一次,常见实现中等价于 0 0 * * *;需要精确到其他时间时,应直接使用五字段表达式。
@daily
在支持 cron 快捷表达式的实现中,@daily 表示每天执行一次;Vixie cron、Cronie 等常见实现通常将它解释为每天午夜执行,即 0 0 * * *。
怎么判读
| 写法 | 含义 | 建议动作 |
|---|---|---|
@daily |
每天执行一次,通常为午夜 | 只要求“每天一次”时可直接使用 |
0 0 * * * |
每天 00:00 执行 | 需要显式表达时间时使用 |
30 2 * * * |
每天 02:30 执行 | 业务要求具体时刻时改用五字段表达式 |
@daily 应出现在 crontab 条目的调度位置,后面紧跟要执行的命令。它表达的是固定的每日调度,不等同于“从配置时刻起每隔 24 小时”。
快速确认
如果当前用户的 crontab 已按示例配置,可以检查条目是否存在:
crontab -l | grep -F '@daily'预期输出:
@daily date >> /tmp/cron-test.log这只能确认调度条目已经安装;真正执行后,/tmp/cron-test.log 才会追加一次 date 输出。
使用边界
@daily 属于 cron 实现提供的快捷表达式,并不是所有调度系统都保证支持。迁移到只接受标准字段的工具时,应改写为 0 0 * * *;若目标执行时间不是午夜,则直接写完整五字段表达式。实际触发时间还受 cron 守护进程使用的时区以及夏令时规则影响,应以目标主机配置为准。
@weekly 表示每周执行一次,常见实现中通常对应周日午夜;如果业务要求明确星期和时间,推荐使用完整五字段表达式。
@weekly
在支持 cron 快捷表达式的实现中,@weekly 表示每周执行一次;Vixie cron、Cronie 等常见实现通常将它解释为周日午夜执行,即 0 0 * * 0。
怎么判读
| 写法 | 含义 | 建议动作 |
|---|---|---|
@weekly |
每周执行一次,通常为周日 00:00 | 对具体星期和时刻没有额外要求时使用 |
0 0 * * 0 |
周日 00:00 执行 | 需要显式表达默认周调度时使用 |
0 3 * * 1 |
周一 03:00 执行 | 业务要求明确星期和时间时使用 |
@weekly 是固定周历调度,不表示“从上一次执行起每隔 7×24 小时”。如果运维要求指定周一、工作日或其他准确时刻,应使用完整五字段表达式,避免只凭快捷名称推断执行窗口。
快速确认
如果当前用户的 crontab 已按示例配置,可以检查条目是否存在:
crontab -l | grep -F '@weekly'预期输出:
@weekly date >> /tmp/cron-test.log该结果确认条目已经写入当前用户的 crontab;任务真正触发后,/tmp/cron-test.log 才会新增对应的时间记录。
使用边界
@weekly 是常见 cron 实现支持的扩展快捷表达式,并非所有调度器都接受。迁移到只支持字段语法的平台时,可使用 0 0 * * 0 表达常见的周日午夜语义;星期字段的具体取值约定和时区行为仍应以目标实现文档为准。
@monthly 通常表示每月 1 日午夜执行一次,可作为 0 0 1 * * 的简写;需要其他日期或时间时应使用完整表达式。
@monthly 每月快捷表达式
@monthly 是传统 cron 的特殊时间字符串。在支持该扩展的实现中,它通常等价于 0 0 1 * *:按 cron 守护进程使用的时区,在每月 1 日 00:00 触发一次。它只替代五个时间字段,后面仍需跟要执行的命令。
怎么判读
| 写法 | 含义 | 建议动作 |
|---|---|---|
@monthly |
每月 1 日 00:00 触发 | 适合固定的月初午夜任务 |
0 0 1 * * |
与 @monthly 的常见语义相同 |
需要显式展示五字段时使用 |
| 其他日期或时间 | @monthly 无法附加时间字段调整 |
改用完整五字段表达式 |
快速确认
把 @monthly date >> /tmp/cron-test.log 写入当前用户的 crontab 后,可检查该条目是否已经保存:
crontab -l | grep -F '@monthly date >> /tmp/cron-test.log'预期输出:
@monthly date >> /tmp/cron-test.log这只验证配置已经写入;真正触发后,date 的输出会追加到 /tmp/cron-test.log,具体时间文本受系统时区和区域设置影响。
适用范围
@monthly 属于 Vixie Cron、Cronie 等实现广泛支持的快捷写法,但不是所有调度器都保证支持。迁移到精简版 cron、容器内调度器或其他调度系统时,应先查对应实现的 crontab 文档。
语法边界与易错点
传统 Vixie Cron 系实现中,日期和星期字段都被限制时通常采用 OR 语义,只要其中一个匹配就可能执行,不能简单理解成两个条件同时满足。
日期与星期同时限制
在传统 Vixie Cron 及其常见兼容实现中,当“日期”和“星期”两个字段都不是通配条件时,它们通常按 OR 判定:任意一个字段匹配就会触发。若两者在同一分钟同时匹配,也只会执行一次。
怎么判读
以 0 9 13 * 5 为例,13 表示每月 13 日,5 表示星期五;因此它表示“每月 13 日或每个星期五的 09:00”,而不是“恰逢星期五的 13 日”。
| 匹配情况 | 是否触发 | 建议动作 |
|---|---|---|
| 日期匹配,星期不匹配 | 是 | 按 OR 语义理解 |
| 日期不匹配,星期匹配 | 是 | 按 OR 语义理解 |
| 日期和星期都匹配 | 是,执行一次 | 不会因为双重匹配执行两次 |
| 两者都不匹配 | 否 | 等待下一次任一条件匹配 |
主示例
下面把 OR 写法与“只在星期五且为 13 日”这一 AND 需求放在同一个 crontab 片段中对照。第二行先让 cron 只在星期五启动,再由命令检查日期;Vixie 风格 crontab 中命令里的 % 需要写成 \%,避免被 cron 当作特殊分隔符。
# OR:13 日或星期五
0 9 13 * 5 date >> /tmp/cron-or.log
# AND:星期五触发后,再检查是否为 13 日
0 9 * * 5 [ "$(date +\%d)" = 13 ] && date >> /tmp/cron-and.log预期结果:以 2026 年 11 月为例,第一行会在 6、13、20、27 日的 09:00 触发;第二行只会在 13 日 09:00 通过日期检查并执行命令。
适用范围
这种日期与星期的 OR 规则来自传统 Vixie Cron 语义,Cronie 等兼容实现通常沿用。Quartz、systemd timer、云调度服务或厂商扩展可能使用不同字段和组合规则,不能把这里的 OR 语义直接外推。
*/5 表示匹配时钟上的 5 分钟刻度,并不是任务结束后再等待 5 分钟;任务执行时间过长时可能出现多个实例同时运行。
Cron 不保证固定时间间隔
*/5 放在分钟字段时,表示匹配当前时钟中的周期刻度,例如 00、05、10、15 分。Cron 不会等待上一次任务结束后再计时,因此单次执行超过 5 分钟时,后续匹配点仍可能启动新的实例。
怎么判读
| 线索 | 含义 | 建议动作 |
|---|---|---|
*/5 * * * * |
每小时中满足 5 分钟步进的时刻触发 | 按日历时间理解,不要按“完成后等待 5 分钟”理解 |
| 单次任务耗时超过 5 分钟 | 下一次触发时前一实例可能仍未结束 | 检查是否允许并发执行 |
| 同一脚本同时存在多个进程 | 已经发生执行重叠 | 增加互斥锁或改用支持串行调度的机制 |
快速确认匹配语义
下面用分钟值直观看出 */5 对应的是时钟刻度,而不是任务完成时间:
for minute in 0 5 10 15; do
echo "minute=$minute -> match"
done预期输出:
minute=0 -> match
minute=5 -> match
minute=10 -> match
minute=15 -> match实际 Cron 会在每个匹配时刻重新判断并尝试启动任务;系统繁忙时启动可能略有延迟,但这种延迟不会把后续计划整体改成以上一次完成时间为起点。
处理顺序
先确认任务是否允许重入。如果必须保证同一时间只有一个实例,可在支持 flock 的 Linux 系统中使用文件锁,或由应用自身实现互斥。若需求本身是“任务结束后再等待固定时长”,应选择支持 fixed-delay 一类语义的调度机制,而不是依赖普通 Cron 表达式。
/etc/crontab 和 /etc/cron.d/* 常在五个时间字段后额外要求一个用户名,再跟执行命令;不要直接照搬用户 crontab -e 中的格式。
系统 crontab 多一个用户字段
系统级 crontab 通常需要在五个时间字段之后写明以哪个用户身份执行命令;通过 crontab -e 编辑的用户 crontab 已经由所属账户确定执行身份,因此没有这个用户名字段。两种格式直接互相复制,字段就会错位。
怎么判读
| 来源 | 五个时间字段之后 | 建议动作 |
|---|---|---|
/etc/crontab |
用户名,再跟命令 | 明确填写执行用户 |
/etc/cron.d/* |
常见实现中也是用户名,再跟命令 | 按系统级格式编写 |
crontab -e |
直接是命令 | 不要额外填写用户名 |
把系统级条目中的 root 原样复制到用户 crontab 时,Cron 会把 root 当成命令的一部分;反过来,系统级文件缺少用户名时,Cron 可能把原本的命令名误当成执行用户,最终导致条目无法按预期运行。
快速确认格式
下面两行分别展示常见的系统级格式和用户级格式:
system_line='*/5 * * * * root /usr/local/bin/job.sh'
user_line='*/5 * * * * /usr/local/bin/job.sh'
echo "$system_line"
echo "$user_line"预期输出:
*/5 * * * * root /usr/local/bin/job.sh
*/5 * * * * /usr/local/bin/job.sh第一行的第六个字段 root 是执行用户;第二行的第六个字段已经是命令 /usr/local/bin/job.sh。
处理顺序
复制 Cron 条目前,先确认目标位置属于系统级文件还是用户 crontab。写入 /etc/crontab 或采用相同格式的 /etc/cron.d/* 时补上正确用户名;写入 crontab -e 时删除该字段。修改后再检查 Cron 服务日志和任务实际执行身份,避免只凭表达式外观看起来正确就判断配置已经生效。
Quartz Cron 通常包含秒字段,并支持传统 Linux crontab 没有的扩展语法;从 Spring、Quartz 文档复制表达式前,应确认目标调度器类型。
Cron 与 Quartz 字段不同
传统 Linux crontab 与 Quartz 都使用空格分隔时间字段,但字段数量、字段顺序和扩展符号并不相同。迁移表达式时应先确认目标调度器,再逐字段转换,不能只看表达式外形是否相似。
怎么判读
| 调度器 | 常见字段 | 关键差异 | 建议动作 |
|---|---|---|---|
| Linux crontab | 分 时 日 月 星期 |
通常为 5 个时间字段,没有秒字段 | 按目标系统的 crontab 文档编写 |
| Quartz Cron | 秒 分 时 日 月 星期 [年] |
秒字段位于最前,年字段可选,并支持多种扩展符号 | 使用 Quartz 语义重新核对每个字段 |
| Spring Cron | 通常为 秒 分 时 日 月 星期 |
同样常见 6 字段,但不要据此假定与所有 Quartz 扩展完全等价 | 以当前 Spring 版本文档为准 |
字段数量是最快的初筛线索,但不能代替语法校验。例如 0 0 2 * * ? 的首个 0 是秒字段,而 Linux crontab 中 0 2 * * * 的首个 0 是分钟字段。
快速确认
下面只用字段数量直观看出两种表达式的结构差异,不负责验证完整 Cron 语义。
printf '%s\n' '0 2 * * *' '0 0 2 * * ?' | awk '{print NF, $0}'预期输出:
5 0 2 * * *
6 0 0 2 * * ?迁移时怎么处理
从 Quartz 或 Spring 文档复制表达式到 Linux crontab 时,先确认是否存在秒字段,再检查 ?、L、W、# 等目标实现可能不支持的扩展符号。反向迁移时也不要机械地在最前面补 0,因为日期与星期字段的规则仍可能不同。
适用范围
这里的 Linux crontab 指常见的传统 5 字段实现;不同 Unix 工具、容器平台、云调度服务和应用框架可能定义自己的 Cron 方言。最终应以实际调度器及其版本文档为准。
? 常见于 Quartz,用于日期或星期字段表示不指定具体值;传统 Linux crontab 通常不支持这种写法,不能直接从 Quartz 表达式复制。
问号不是标准 crontab 语法
在 Quartz Cron 中,? 用于日期或星期字段表示“不指定具体值”,常用于只约束其中一个字段的场景。传统 Linux crontab 没有这一语义,因此包含 ? 的 Quartz 表达式不能原样复制进去。
怎么判读
| 线索 | 含义 | 建议动作 |
|---|---|---|
日期字段出现 ? |
Quartz 不指定具体日期 | 检查星期字段承担了什么约束 |
星期字段出现 ? |
Quartz 不指定具体星期 | 检查日期字段承担了什么约束 |
Linux crontab 中出现 ? |
很可能复制了其他 Cron 方言 | 按 5 字段 crontab 语义重新表达条件 |
例如 Quartz 表达式 0 0 12 ? * MON-FRI 表示在工作日 12:00:00 触发,其中星期字段给出约束,日期字段使用 ?。在常见 Linux crontab 中,可按其字段规则改写为 0 12 * * 1-5。
快速确认
下面的命令展示这两个表达式的字段数量和文本,便于发现不能直接复制的结构差异。
printf '%s\n' '0 0 12 ? * MON-FRI' '0 12 * * 1-5' | awk '{print NF, $0}'预期输出:
6 0 0 12 ? * MON-FRI
5 0 12 * * 1-5处理顺序
发现 ? 时,先确认表达式来源是否为 Quartz、Spring 或其他支持该符号的实现,再确定它位于日期还是星期字段。迁移到传统 crontab 时,应重新表达实际调度条件,而不是简单删除 ?,否则字段位置可能错位并改变执行时间。
适用范围
? 是否可用取决于 Cron 方言。Quartz 明确定义了相关用法,而传统 Linux crontab 通常不支持;其他框架和托管调度服务可能采用不同扩展规则,应以目标产品当前版本文档为准。
L、W、# 常用于 Quartz 等扩展 Cron 表达式表示最后一天、工作日或第几个星期几,不能假设 Linux crontab 默认支持。
L、W 和 # 扩展语法
L、W、# 不是传统 Linux crontab 五字段语法的通用能力,它们常见于 Quartz CronTrigger 等扩展实现。看到这些字符时,第一步应确认表达式由哪个调度器解析,不能直接按系统 crontab 理解。
值与含义
| 写法 | Quartz 中的典型含义 | 建议动作 |
|---|---|---|
L |
在日期字段表示当月最后一天 | 确认是否为 Quartz 或兼容实现 |
15W |
距当月 15 日最近的工作日 | 检查目标调度器是否支持 W |
6#3 |
当月第 3 个星期五 | 核对星期编号规则后再使用 |
Quartz 的星期字段通常使用 1 到 7 表示星期日到星期六,因此 6#3 表示第三个星期五。其他调度器可能采用不同编号或根本不支持该语法。
片段示例
下面是 Quartz CronTrigger 表达式,需要由 Quartz 调度器解析,并非可直接写入 Linux crontab 的五字段条目。
0 0 9 L * ?
0 0 9 15W * ?
0 0 9 ? * 6#3预期匹配:三个表达式分别表示每月最后一天 09:00、每月最接近 15 日的工作日 09:00,以及每月第三个星期五 09:00。
判读与处理
如果表达式包含 L、W 或 #,先查目标调度器的 Cron 文档,再核对字段数量、星期编号及日期字段规则。Quartz 常使用“秒、分、时、日、月、星期”并可附加年份,与 Linux crontab 的五字段格式不同。
Cron 任务通常不会继承交互式 Shell 的完整环境,PATH、工作目录和自定义变量可能不同;生产任务应使用明确路径或主动配置环境。
Cron 使用自己的执行环境
Cron 启动任务时通常不会复制用户当前交互式 Shell 的完整环境。脚本在终端中能运行、放进 Cron 后却提示命令不存在或找不到文件时,应优先检查 PATH、工作目录和所需环境变量。
怎么判读
| 线索 | 常见原因 | 建议动作 |
|---|---|---|
command not found |
Cron 的 PATH 较短 |
显式设置 PATH 或使用命令绝对路径 |
| 相对路径文件不存在 | 任务启动目录与预期不同 | 在命令前明确 cd 到工作目录 |
| API Key、运行模式等变量为空 | 交互式 Shell 配置未被加载 | 在 crontab、脚本或专用环境文件中显式配置 |
| 终端正常、Cron 失败 | 依赖了登录 Shell 初始化文件 | 不要假设 .profile、.bashrc 等会自动生效 |
快速确认
可以临时加入一个诊断任务,主动固定关键变量并把实际环境写入文件。以下内容应放入当前用户的 crontab;它每分钟执行一次,验证后应删除诊断任务。
SHELL=/bin/sh
PATH=/usr/bin:/bin
APP_ENV=production
* * * * * cd /tmp && /usr/bin/env > /tmp/cron-env.txt 2>&1生效行为:任务运行后会在 /tmp/cron-env.txt 中记录 Cron 实际传给进程的环境。等待任务至少执行一次后,可检查关键变量:
grep -E '^(APP_ENV|PATH)=' /tmp/cron-env.txt | sort预期输出:
APP_ENV=production
PATH=/usr/bin:/bin生产任务写法
生产任务应尽量消除对隐式环境的依赖:为关键命令使用绝对路径,显式配置必要的 PATH 和业务变量,并在需要固定工作目录时先执行 cd。敏感凭据不要直接写入可被无关用户读取的 crontab 或日志。
具体默认变量、默认 PATH 和启动目录会随 Cron 实现及操作系统发行版变化,因此应以目标机器上的实现和实际诊断结果为准。
Cron 启动任务时的工作目录可能与手动执行命令时不同,脚本、日志和配置文件使用相对路径容易找不到文件;生产任务优先使用绝对路径。
相对路径容易执行失败
Cron 启动任务时不能假定当前工作目录就是脚本所在目录。手动执行正常、定时执行却提示文件不存在时,应先检查脚本路径、配置路径、日志路径以及程序内部读取的相对路径。
怎么判读
| 线索 | 含义 | 建议动作 |
|---|---|---|
./run.sh 找不到 |
Cron 当前目录不是预期目录 | 改为脚本的绝对路径 |
config.json 找不到 |
程序按当前目录解析相对路径 | 使用绝对路径或先切换目录 |
>> logs/job.log 失败 |
日志目录按 Cron 当前目录解析 | 日志文件使用绝对路径 |
| 手动运行成功、Cron 失败 | 两种启动环境存在差异 | 同时检查工作目录、环境变量和权限 |
快速确认
可临时让任务记录实际工作目录:
/bin/pwd > /tmp/cron-pwd.txt
/bin/cat /tmp/cron-pwd.txt预期输出:
<PATH><PATH> 是 Cron 启动命令时的实际工作目录,具体值取决于系统和任务配置。
建议写法
生产任务优先把可执行文件、脚本、配置和重定向目标都写成绝对路径。例如不要依赖 ./backup.sh 和 logs/backup.log,而是明确写出它们的位置。若程序必须以某个目录作为工作目录,可以在同一条任务中先执行 cd:
cd /opt/app && /opt/app/bin/backup.sh >> /var/log/app/backup.log 2>&1预期结果:脚本以 /opt/app 为当前工作目录执行,标准输出和标准错误追加到 /var/log/app/backup.log;实际日志内容由脚本决定。
Cron 通常按照系统或守护进程使用的时区判断执行时间;服务器使用 UTC 而业务按北京时间计算时,表达式即使语法正确也可能出现时间偏移。
时区影响实际执行时间
Cron 表达式只描述钟表时间,不会自动理解“北京时间”或其他业务时区。服务器或 Cron 守护进程使用的时区与业务时区不一致时,表达式语法即使完全正确,实际执行时刻也会发生固定偏移。
怎么判读
| 线索 | 含义 | 建议动作 |
|---|---|---|
| 每天都固定早或晚若干小时 | 系统时区与业务时区不同 | 先确认 Cron 使用的时区 |
服务器显示 UTC |
Cron 很可能按 UTC 判断时间 | 将业务时间换算成 UTC,或使用实现支持的时区配置 |
| 夏令时切换附近异常 | 当地时区发生钟表跳变或重复 | 检查目标时区的 DST 规则 |
| 多台机器执行时刻不同 | 主机时区配置不一致 | 统一时区策略并逐台验证 |
快速确认
先查看当前系统显示的时区缩写和 UTC 偏移:
date '+%Z %z %F %T'预期输出:
<ZONE> <OFFSET> <TIME>例如 <ZONE> 可能是 UTC,<OFFSET> 可能是 +0000;具体日期和时间属于动态值。
换算执行时间
如果服务器按 UTC 调度,而业务要求北京时间每天 09:00 执行,北京时间通常为 UTC+8,因此对应 UTC 01:00:
0 1 * * * /opt/app/bin/daily-job.sh预期结果:在 Cron 确实按 UTC 判断表达式的前提下,任务每天 UTC 01:00 触发,对应 UTC+8 时区的 09:00。
涉及夏令时的地区还要额外验证时钟跳变日。若业务要求严格按某个地区的当地时间运行,优先明确调度器的时区能力,而不是长期手工维护固定 UTC 偏移。