cron4j表达式每天：含义、写法与常见误区

cron4j 五个字段与「每天」的关系

cron4j 的表达式由空格分隔的五个字段组成，顺序固定为：分钟、小时、日期、月份、星期。要让任务每天都执行，关键在于让「日期」和「月份」两个字段保持通配状态，同时让「星期」字段也保持通配，这样时间维度上就不会被限定到某一天、某一月或某一星期几。

真正决定「一天中的哪个时刻」的是前两个字段。分钟字段决定小时内的第几分钟，小时字段决定一天中的第几个小时。把这两个字段写成固定值，任务就会在每天的同一时刻触发；把它们写成范围或列表，任务就会在每天内的多个时刻触发。

需要特别留意的是，cron4j 的星期字段取值习惯与部分其他 cron 实现不同，它通常以星期一到星期日作为一周的起点，而不是以星期日开头。如果从别的调度器迁移表达式，星期字段的数值含义可能整体错位，导致「每天」被意外收窄成「每周某天」。

「每天」在匹配层面的原理

调度器判断是否触发，是把当前时间拆成五个分量，再逐个与表达式字段比对。只有当五个字段同时匹配时，任务才会被触发。因此「每天」并不是一个单独的开关，而是日期、月份、星期三个字段都处于「任意值」状态的自然结果。

日期字段使用通配符时，意味着一个月里的任何一天都满足条件；月份字段使用通配符时，意味着一年里的任何月份都满足条件；星期字段使用通配符时，意味着任何星期几都满足条件。三者叠加，剩下的约束就只有分钟和小时，于是任务在每一天的对应时刻执行。

这里有一个容易被忽略的细节：日期字段和星期字段在多数 cron 实现中属于「或」的关系，只要其中一个匹配就可能触发。如果日期字段被写成了某个具体日子，而星期字段仍是通配符，那么任务不会变成「每天」，反而可能在某些月份出现额外触发或完全不触发的情况。所以想让任务每天都跑，最稳妥的做法是让日期和星期两个字段都保持通配，不要只改其中一个。

常见的每天写法与适用场景

最直观的每天写法，是把分钟和小时写成固定值，其余三个字段写成通配符。这种形式适合日报生成、每日数据汇总、日志归档这类每天只需执行一次的任务。

如果任务需要在每天内多次执行，可以把分钟字段写成列表或范围，例如在某个小时的多个分钟点上触发；也可以把小时字段写成范围，让任务在白天的工作时段内按固定分钟间隔触发。这类写法适合轮询类任务，但要注意触发次数会随字段取值数量成倍增加。

还有一种写法是只固定分钟、把小时写成通配符，这会让任务在每个小时的第几分钟都执行一次，本质上属于「每小时」而非「每天一次」。很多人在描述需求时说「每天跑」，实际写出来的表达式却是每小时触发，上线后才发现执行频率远超预期。因此在写表达式之前，先明确「每天一次」还是「每天多次」，再决定小时字段是固定值还是通配符。

跨天、时区与边界注意事项

第一，注意午夜边界的归属。把触发时刻设在零点附近时，任务究竟算前一天还是后一天，取决于调度器对日期的切分方式，也取决于表达式里日期字段是否被限定。如果业务逻辑依赖「某天的数据」，建议把触发时刻稍微错开午夜，避免数据尚未落库就开始统计。

第二，注意时区。cron4j 表达式本身不携带时区信息，触发时刻由运行环境的默认时区决定。同一份表达式部署到不同时区的机器上，实际触发时刻会整体平移。跨区域部署时，应统一运行环境的时区设置，或在代码层面显式指定时区。

第三，注意夏令时切换。在实行夏令时的地区，时钟回拨或前拨可能造成某个时刻出现两次或直接跳过。对于每天只跑一次的任务，这种影响通常表现为当天多跑一次或漏跑一次，需要在业务侧做幂等处理。

第四，注意任务自身耗时。如果一次执行跨越了下一个触发点，而调度器又不做并发控制，就可能出现任务叠加。对每天执行的任务来说，应确保单次执行时间远小于触发间隔，或为任务加上运行状态标记。

常见问题