Cron 表达式是用来定义定时任务执行规则的字符串。它通过若干字段分别描述分钟、小时、日、月、星期等时间单位，组合起来就能表达“每天凌晨三点执行”“每周一上午十点半执行”这类调度需求。写错字段顺序或取值范围，任务就可能在不该跑的时间触发，因此理解字段含义和常见写法是配置定时任务的第一步。
Cron 表达式的基本结构
常见的 Cron 表达式由五个字段组成，字段之间用空格分隔。从左到右依次是：
- 分钟
- 小时
- 日
- 月
- 星期
有些系统会在最前面增加一个“秒”字段，变成六个字段。你使用的平台是否支持秒字段，取决于具体的调度实现。配置前先确认字段数量，避免把分钟写到秒的位置。
每个字段可以填写具体数值，也可以使用特殊符号表示范围或重复。字段顺序固定，不能随意调换。把分钟和小时的顺序写反，是新手最容易犯的错误之一，结果就是任务在完全不同的时间点执行。
各字段的含义与取值范围
以下是五个基本字段的常见取值范围：
分钟\n表示一小时内的第几分钟，通常取值 0 到 59。
小时\n表示一天内的第几小时，通常取值 0 到 23，采用 24 小时制。凌晨三点对应 3，下午三点对应 15。
日\n表示一个月中的第几天，通常取值 1 到 31。
月\n表示一年中的第几个月，通常取值 1 到 12。
星期\n表示一周中的星期几，通常取值 0 到 6 或 1 到 7，具体哪一天代表周日、哪一天代表周一，不同实现可能不同，使用前需要确认。
如果系统支持秒字段，秒的取值范围通常是 0 到 59，并且位于最前面。
常用符号的含义
Cron 表达式中的符号用来表达“任意”“间隔”“范围”“列举”等逻辑。
：表示该字段的任意值。例如分钟位置写，表示每分钟都触发。,：表示列举多个值。例如在星期位置写1,3,5，表示这几个星期几都触发。-：表示一个连续范围。例如在小时位置写9-18，表示从 9 点到 18 点之间。/：表示从某个起点开始按固定间隔重复。例如在分钟位置写*/5，表示每隔 5 分钟触发一次。?：在某些实现中用于“日”或“星期”字段，表示不指定具体值。它和*有区别，具体行为取决于所用调度系统。
这些符号可以组合使用，但组合越复杂，越容易写错。建议先用简单表达式验证，再逐步增加条件。
手写 Cron 表达式的分步方法
如果你需要自己写一个 Cron 表达式，可以按以下步骤操作：
- 明确任务的执行频率。是每天、每小时、每周，还是只在某些特定日期执行。
- 确定使用几个字段。先确认你的调度系统是五字段还是六字段。
- 从分钟字段开始填写。例如“每天凌晨三点”对应分钟为 0。
- 填写小时字段。凌晨三点对应小时为 3。
- 填写日、月、星期字段。如果每天都要执行，日、月、星期通常写
*。 - 组合成完整表达式。每天凌晨三点可以写成
0 3 *。 - 检查字段顺序和取值范围。确认没有把分钟和小时写反，没有超出范围。
- 预览下次执行时间。很多工具或平台提供“下次执行时间”预览，能直接列出接下来几次触发时间，用来验证表达式是否符合预期。
以“每个工作日上午十点半执行一次”为例：
- 分钟为 30
- 小时为 10
- 日写
* - 月写
* - 星期限定为周一到周五
组合后得到类似 30 10 1-5 的表达式。具体星期编号需要根据你的系统确认。
使用生成器与预览功能
如果你不想手写，可以使用 Cron 表达式生成器。这类工具通常提供可视化界面，把秒、分、时、日、月、星期分别列出，你只需要点选“每天”“每小时”“每周一”等选项，工具会自动生成对应的表达式。
生成器通常还支持输入一个具体日期时间，例如某年某月某日早上八点三十分，然后直接生成对应表达式。部分工具还会显示“下次执行时间”预览，列出接下来几次触发时间，帮助你确认配置是否正确。
使用生成器时仍然需要注意字段数量是否与你的系统一致，以及星期编号的定义是否相同。生成器给出的表达式只是字符串，最终是否按预期执行，还取决于调度系统本身的解析规则。
常见错误与排查思路
配置定时任务时，以下问题比较常见：
- 字段顺序写反，导致任务在错误的时间执行。
- 字段数量与系统要求不一致，多写或少写一个字段。
- 星期编号理解错误，把周一当成周日。
- 特殊符号组合过于复杂，实际含义与预期不符。
- 没有预览下次执行时间，配置完成后没有验证。
排查时可以先简化表达式，只保留最基本的触发条件，确认任务能正常执行后，再逐步增加限制。同时查看任务日志，确认实际触发时间。
适用与不适用场景
Cron 表达式适合按固定时间规律重复执行的任务，例如定时生成报表、定时清理临时文件、定时同步数据等。
它不适合需要复杂依赖关系的任务调度，例如任务 A 必须在任务 B 成功后才能执行。也不适合需要精确到毫秒级触发的场景。对于跨时区调度，还需要确认系统使用的时区设置。
常见问题
Cron 表达式五个字段分别代表什么？
从左到右依次是分钟、小时、日、月、星期。部分系统在最前面增加秒字段。
每天凌晨三点执行怎么写？
五字段写法通常是 0 3 *，表示分钟为 0、小时为 3，其余字段为任意值。
每个工作日上午十点半执行怎么写？
分钟为 30，小时为 10，星期限定为周一到周五，日、月写 *。具体星期编号需按系统确认。
为什么任务没有在预期时间执行？
常见原因包括字段顺序写反、字段数量不符、星期编号理解错误、特殊符号组合有误。建议简化表达式并查看下次执行时间预览和任务日志。
生成器生成的表达式可以直接用吗？
可以，但需要确认生成器的字段数量、星期编号定义与你的调度系统一致。生成后最好用预览功能验证下次执行时间。