cron每周表达式：从星期字段说起
排每周任务时，很多人会卡在 cron 的星期字段上：明明写了数字，任务却在不该跑的日子触发；或者把日期和星期同时填上，结果完全不符合预期。这里围绕 cron每周表达式，把星期字段的含义、常见写法和容易忽略的细节讲清楚，让你在配置定时任务时心里有底。
星期字段到底从几算起
cron 的星期字段是每周任务的核心。多数实现里，星期用数字表示，范围从 0 到 6，0 对应周日，6 对应周六；也有实现同时接受 7 作为周日，或者用英文缩写 SUN、MON 这类写法。麻烦在于不同调度器对边界的处理并不完全一致，有的把 7 当作周日，有的直接报错。写每周任务前，先确认你用的调度器文档，别凭记忆下笔。
另一个容易混淆的点是：星期字段和月份、日期字段一样，都是“满足条件即触发”，不是“从某天开始算”。比如只填一个数字，表示每周的那一天触发；填多个用逗号分隔，表示一周内多天触发。理解这一点，后面组合条件时才不会想当然。
日期和星期同时填，结果可能出乎意料
不少人想表达“每月某日，且那天正好是周几”，于是把日期字段和星期字段都填上。但在标准 cron 语义里，这两个字段是“或”的关系：只要日期匹配，或者星期匹配，任务就会执行。也就是说，两个字段同时填写，触发次数往往比预期多得多。
想表达“两者都满足”，标准 cron 本身做不到，需要把判断放进脚本里，由程序再检查一次当天是星期几。反过来，如果只想按周触发，最稳妥的做法是日期字段留成星号，只让星期字段起作用。这个习惯能省掉很多排查时间。
一个每周任务的写法示例
假设希望每周一清晨执行一次数据整理脚本。可以写成类似这样的形式：分钟和小时按需填写，日期字段用星号，月份字段用星号，星期字段填 1，命令部分写脚本路径。整行读下来就是“每周一的那个时刻执行”。
如果任务需要一周内跑多次，比如工作日每天一次，就把星期字段写成范围或列表，例如 1-5 表示周一到周五。范围写法比逐个列举更简洁，也更不容易漏掉某天。写完后建议用表达式解析工具核对下次触发时间，确认星期对应关系没搞反。周末任务同理，把星期字段换成对应的数字或缩写即可。
排查每周任务不触发的思路
任务没按预期跑，先看星期字段是不是写成了中文或拼错的缩写，有些调度器对大小写和语言很敏感。再看是否误把日期字段填了具体数字，导致“或”逻辑把触发日打乱。还要留意时区：调度器按自身时区计算，服务器时区和你的本地时间不一致时，周日深夜和周一凌晨很容易错位。
另外，星期字段的取值范围写超了，比如填了 8，有的实现会直接忽略整行而不报错，表现就是“任务像不存在一样”。遇到这种情况，把表达式拆开逐段检查，比盯着日志猜要快得多。
总结
写好 cron每周表达式，关键在星期字段：弄清数字与缩写的对应关系，避免日期和星期同时填写带来的“或”逻辑，再结合时区和取值范围排查异常。配置后用解析工具核对触发时间，能提前发现大部分问题。
相关文章
- cron毫秒表达式：精准调度背后的疑问与取舍
解析cron毫秒表达式的含义、适用场景与常见误区，帮助开发者在任务调度中做出合理选择。
- cron每天八点执行一次表达式怎么写才不踩坑
聊聊每天早间整点触发的 cron 表达式怎么写、容易误读的地方，以及时区、星期字段和调试思路。
- cron每天1点表达式详解：从字段到调试
围绕每天凌晨一点的定时需求，拆解cron表达式字段含义，提供分步配置方法、常见错误排查与跨平台注意事项。
- cron每一分钟执行表达式：星号与斜杠到底怎么读
拆解每分钟触发的 cron 表达式写法，讲清五个字段含义、星号与步长的读法，以及排查不触发问题的思路。
- cron每分钟表达式怎么写才不踩坑
讲清cron每分钟表达式的含义、写法与常见误区，帮助开发者理解五个时间字段的取值逻辑与调度实践。
常见问题
Q1星期字段填 7 可以表示周日吗？
部分调度器接受 7 作为周日，但并非所有实现都支持。为稳妥起见，优先用 0 表示周日，或使用英文缩写，并在目标环境里实际验证。
Q2为什么日期和星期都填了，任务反而跑得更频繁？
标准 cron 中这两个字段是“或”关系，任一匹配就会触发。想同时满足两个条件，需要把额外判断写进脚本，而不是只靠表达式。
Q3每周任务可以用英文缩写写星期吗？
多数实现支持 SUN、MON 这类缩写，但大小写和是否允许缩写因调度器而异。跨平台使用时，数字写法兼容性通常更好。
Q4表达式看起来没问题，任务却不执行，先查什么？
先确认时区设置，再检查星期字段是否越界或写错，最后看整行是否被调度器静默忽略。逐段拆开验证比整体猜测更有效。