点一下模板按钮,表达式要先过一趟往返
起因很简单:页面替定时任务拼 5 域或 6 域 Cron 表达式,8 个模板按钮一点就出串,复制走就能用。但把「按钮实参 → 逐域状态 → 重建表达式」这条链在固定假时钟下逐个走一遍之后,8 个按钮里只有 0/1 * * * * * 这一个能逐字回到原样,其余 7 个重建出来都变了形——有的只是换了写法,有的把语义整个丢在半路。
页面本体是一台纯本地逻辑机:模板 16271 字节、327 段行、脚本内文 10299 字符里住着 15 个命名函数,零外部依赖。把内文整段原样读回,配 DOM 桩与固定假时钟跑进虚拟机,上面每一笔往返账都能逐条复现——不需要真实调度器,也不需要联网。
两类不互逆:单值退化与步长被吞
解析那一步靠一个正则:0/1 这类进步长分支,1-5 这类进区间分支,而单独的 0 没有专属分支,直接退化成区间 0-0。于是 0 0 9 * * * 被重建为 0-0 0-0 9-9 * * *:展开集合没变,字面变了。更有意思的是把重建串再喂回解析一次——它已经全是区间形,逐字不动,第二轮起是不动点。这一类共 5 个按钮,算「往返换了皮」。
另一类就不只是换皮。星号打头的步长匹配不上解析正则,该域直接落回通配:0 0 */2 * * * * 重建为 0-0 0-0 * * * *,0 */5 * * * * * 重建为 0-0 * * * * *——「每 2 小时」「每 5 分钟」两个按钮的语义在生成器里走一趟就没了。
顺带说一句方向性:这扇门只朝「从简到繁」开。反例里没有一个重建串会比原串更紧凑,也没有直接报错——解析正则匹配不上就静默落回通配,丢语义这件事在界面上不留任何痕迹,只能靠对照输出框发现。
往返账本:逐字对照
| 模板按钮实参 | 重建串 | 性质 |
|---|---|---|
0/1 * * * * * | 0/1 * * * * * | 唯一逐字互逆 |
0 0 9 * * * | 0-0 0-0 9-9 * * * | 单值退化,集合不变 |
0 0 */2 * * * * | 0-0 0-0 * * * * | 步长被吞,语义丢失 |
0 */5 * * * * * | 0-0 * * * * * | 步长被吞,语义丢失 |
切域不是清空,是藏起来
不点模板只切 5 域/6 域档位时,秒域状态完整保留:先在 6 域把秒设成 30-30,切到 5 域那段整个消失(对齐走 slice(1) 去秒),切回 6 域又原样回来;而点任意模板按钮会整本状态重建。这里还埋着一个误报:默认状态切到 5 域档点预览恒 0 行,弹出「表达式含 L / W / # 等扩展记号,暂不支持执行时间预览(表达式本身仍可用于 Quartz 系统)。」——53 字符 121 字节。原因是 5 域解析路径没碰秒域,它恰好为 null,撞进了本该只抓扩展记号的失败守卫;连步长起点手输 abc 产出 NaN/1 这种串,也被同一句吞了。
换句话说,这句报错审的不是表达式长什么样,而是「哪个域被解析过」——排查时先确认自己停在几域档,比盯着表达式干瞪眼有效得多。
预览器把秒冻在进入那一刻
「未来 5 次执行」预览用 d.setMinutes 每分钟步进、秒不动。假时钟 13:07:23 进入时,秒被钳成「进入时秒+1」即 24,之后整条时间线只在秒 24 上试命中:同一构造下 24-24 * * * * * 5 行全中,25-25 * * * * * 零命中,差的就是被冻住的那一秒。8 个模板按钮里有 7 个直接报「按当前配置一年内没有触发时间」。把时钟拨到 13:07:59 再进,59+1 进位钳到秒 0,同一按钮又正常出 5 行。
窗口本身另有一笔账:MAX_STEPS=1052000,每步 1 分钟,扫满是 730.56 天、约两年的搜索深度,空结果文案却写「一年内没有触发」;构造一个真不可能命中的 2 月 30 日样本扫满,报的仍是同一句。
回到「点模板按钮再复制表达式」的原始场景:只要进入预览那一刻墙钟上的秒和模板对不上,五行列表就整屏看不见,看上去像配置坏了,实际是步进器死板——复制前以输出框里的生成串逐字核对为准,比信预览稳妥。
顺带量到的几笔域解析账
- 列表输入带尾逗号
0,:整域被放大成任意值。 - 分钟域写
0-70展开 71 个键,上界不钳。 - 唯一的钳制点在步长 every:输入 0 或 -5 都被钳成
/1;起点留空静默当 0。 - 日与周同时受限按「或」:表达式
0/1 0-0 0-0 15-15 * 1-1的 5 行预览里,12 月 15 日(周二)照常进表;周域写 7 经 %7 归一后 5 行全是周日。 - 「第 N 次」距今三档取整:分钟档
0 分钟后(差 1 秒 round 后归 0)、19 小时 52 分钟后、天数档 floor 出130 天后。
生成这头量完了;要把重建串贴到另一页去问「它到底什么时候跑」,那是 把表达式交给 crontab 解析器核对下次执行 的活,本文不复述它的结论。这台 按域点选拼 Cron 表达式 的生成器本身随开随用;上面 12 月 15 日进表那笔「或」账想多看几个形状,日与周同时限制时怎么取并集 有场景展开。
快问快答
Q:重建出来的 n-n 区间串,调度器都认吗?
本页只负责产出串。单值退化类展开集合与原串一致,但「本页预览器能解析」不等于「任何调度器都接受这种写法」,复制走之前以输出框里的最终串为准。
Q:点了「每 5 分钟」按钮,预览为什么像每分钟都在跑?
星号打头的步长解析不上、落回通配,重建串的分钟域已经不设限了;预览按重建后的状态步进,所以点完按钮先看一眼生成串再决定是否手动改回。
Q:报「一年内没有触发」,是不是配置真没救?
先动一下秒域或换个整分再试——被冻住的那一秒足以让 8 个按钮里 7 个空手而归;文案里的「一年」也不等于窗口本身,扫满 1052000 步是 730.56 天的深度。
Q:5 域和 6 域来回切会丢设置吗?
只切档不点模板不丢,秒域只是被藏起来,切回原档原样回来;点了模板就整本重建,以按钮实参为准。