常见问题解答

Cron 表达式是由 5 个用空格分隔的字段组成的字符串，用于定义定时任务的执行时间。格式为：

分钟 小时 日期 月份 星期

例如，0 9 * * 1-5 表示"周一到周五的上午9点"。

试试我们的生成器 →

从左到右阅读 Cron 表达式的五个字段：

1. 分钟 (0-59)：一小时中的第几分钟
2. 小时 (0-23)：一天中的第几小时（24小时制）
3. 日期 (1-31)：一个月中的第几天
4. 月份 (1-12)：一年中的第几月
5. 星期 (0-6)：一周中的第几天（0 = 周日）

示例：30 14 * * 2 = "每周二下午2:30"

星号（*）是通配符，表示"每个"或"任意"。

• * * * * * = 每分钟
• 0 * * * * = 每小时（在第0分钟）
• 0 0 * * * = 每天午夜
• 0 0 * * 0 = 每周日午夜

这是 Cron 表达式中最常用的特殊字符。

cron 是 Linux/Unix 系统中基于时间的任务调度器，是一个后台守护进程，负责运行定时任务。

crontab（cron table）是包含 cron 任务列表及其执行时间的配置文件。每个用户都可以有自己的 crontab 文件。

可以把 cron 理解为引擎，crontab 理解为配置表。

Cron 每分钟检查一次是否有任务需要执行。这就是为什么 Cron 表达式中最小的时间单位是分钟——你不能用标准 cron 来调度每秒执行的任务。

如果需要秒级调度，你需要使用替代方案，如 systemd timers 或自定义脚本。

不可以，标准 cron 不支持秒级调度。最小间隔是一分钟。

替代方案：

1. 每分钟运行一个脚本，在脚本内用 sleep 实现秒级循环
2. 使用 systemd timers（Linux）配合 OnUnitActiveSec
3. 使用编程语言的调度器，如 node-cron、APScheduler（Python）
4. 使用任务队列，如 Celery、RabbitMQ

逗号用于在单个字段中指定多个值。

示例：

• 0 8,12,18 * * * = 每天8点、12点、18点
• 0 0 * * 1,3,5 = 每周一、三、五的午夜
• 0 9 1,15 * * = 每月1号和15号的上午9点

短横线用于指定值的范围。

示例：

• 0 9-17 * * * = 上午9点到下午5点，每小时执行
• 0 0 * * 1-5 = 周一到周五的午夜
• */15 9-17 * * * = 上午9点到下午5点，每15分钟执行

范围是包含首尾的（起始和结束都会被包含）。

斜杠指定步长值或"每隔N个"的间隔。

示例：

• */5 * * * * = 每5分钟
• 0 */2 * * * = 每2小时
• */15 9-17 * * * = 上午9点到下午5点之间，每15分钟
• 0 0 */3 * * = 每3天午夜执行

格式：起始值/步长 或 */步长

可以！许多 cron 实现支持特殊字符串作为快捷方式：

• @yearly 或 @annually = 0 0 1 1 *（1月1日午夜）
• @monthly = 0 0 1 * *（每月1号午夜）
• @weekly = 0 0 * * 0（每周日午夜）
• @daily 或 @midnight = 0 0 * * *
• @hourly = 0 * * * *
• @reboot = 系统启动时执行一次

注意：并非所有系统都支持这些。使用前请测试！

L 字符代表"最后"（Last），在某些 cron 实现（如 Quartz）中使用：

• 0 0 L * * = 每月最后一天
• 0 0 * * 5L = 每月最后一个周五
• 0 0 L-3 * * = 每月倒数第3天

警告：标准 Unix cron 不支持！主要用于：

• Java Quartz Scheduler
• AWS EventBridge
• Spring @Scheduled 注解

表达式：0 0 * * *

含义：

• 分钟：0
• 小时：0（午夜）
• 日期：*（每天）
• 月份：*（每月）
• 星期：*（任意）

查看更多每日执行示例 →

表达式：*/5 * * * *

含义：

• 分钟：*/5（每5分钟）
• 小时：*（每小时）
• 日期：*（每天）
• 月份：*（每月）
• 星期：*（任意）

任务将在以下时间执行：00:00、00:05、00:10、00:15、...、23:55

表达式：0 9 * * 1-5

表示周一到周五上午9点执行。

替代写法：0 9 * * MON-FRI（如果系统支持星期名称）

仅周末：0 9 * * 0,6 或 0 9 * * SAT,SUN

星期值对照：

• 0 或 7 = 周日
• 1 = 周一
• ...
• 6 = 周六

表达式：0 2 * * *

凌晨2点是备份的热门时间，原因：

• 系统负载低（大部分用户已下线）
• 不会影响工作时间
• 有充足时间在工作时间前完成

示例命令：

0 2 * * * /usr/local/bin/backup-database.sh

表达式：0 0 1 * *

表示每月1号午夜执行。

变化形式：

• 每月第一个周一：0 0 1-7 * 1
• 每月第一个工作日：0 0 1-3 * 1-5
• 每月最后一天：需要脚本逻辑或高级功能支持

有两种选择：

方法1：多个 crontab 条目

0 9 * * * /path/to/job1.sh
0 9 * * * /path/to/job2.sh

方法2：一个条目多个命令

0 9 * * * /path/to/job1.sh && /path/to/job2.sh

或并行运行：

0 9 * * * /path/to/job1.sh & /path/to/job2.sh

最佳实践：创建一个包装脚本，调用多个任务并进行适当的错误处理。

Cron 默认使用服务器的系统时区。处理时区的方法：

方法1：设置 CRON_TZ（现代 cron）

CRON_TZ=Asia/Shanghai
0 9 * * * /path/to/job.sh

方法2：在命令中使用 TZ

0 9 * * * TZ=Asia/Shanghai /path/to/job.sh

方法3：手动换算时间

如果服务器是 UTC，你想要北京时间上午9点（UTC+8）：

0 1 * * * /path/to/job.sh  # 01:00 UTC = 09:00 北京时间

注意：并非所有实现都支持 CRON_TZ。使用前请测试！

如果任务执行时间超过调度间隔，可能导致重叠执行。解决方案：

方法1：使用 flock（文件锁）

*/5 * * * * flock -n /tmp/myjob.lock /path/to/job.sh

方法2：在脚本中检查 PID 文件

#!/bin/bash
PIDFILE=/tmp/myjob.pid
if [ -f $PIDFILE ]; then
  kill -0 $(cat $PIDFILE) && exit
fi
echo $$ > $PIDFILE
# 你的任务代码
rm $PIDFILE

方法3：使用任务队列系统

• Celery（Python）
• Bull/BullMQ（Node.js）
• Sidekiq（Ruby）

默认情况下，cron 通过邮件发送输出。要记录到文件：

重定向标准输出和错误：

0 2 * * * /path/to/backup.sh >> /var/log/backup.log 2>&1

分别记录日志：

0 2 * * * /path/to/job.sh >> /var/log/job.log 2>> /var/log/job-error.log

添加时间戳：

0 2 * * * echo "[$(date)] 开始任务" >> /var/log/job.log && /path/to/job.sh >> /var/log/job.log 2>&1

使用 logger 记录到 syslog：

0 2 * * * /path/to/job.sh 2>&1 | logger -t myjob

常见问题：

1. 语法错误：用 我们的生成器 验证表达式
2. PATH 错误：Cron 的 PATH 有限。使用绝对路径：

   0 2 * * * /usr/bin/python3 /home/user/script.py

3. 权限拒绝：确保脚本可执行：

   chmod +x /path/to/script.sh

4. Cron 服务未运行：

   sudo systemctl status cron  # 或 crond

5. 用户 crontab 未加载：

   crontab -l  # 验证你的条目

调试技巧：

• 先手动运行命令
• 检查 /var/log/syslog 或 /var/log/cron
• 先用简单命令测试：* * * * * echo "test" >> /tmp/crontest.log

Kubernetes 使用 CronJob 资源，语法类似：

apiVersion: batch/v1
kind: CronJob
metadata:
  name: my-cronjob
spec:
  schedule: "0 */2 * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: my-job
            image: my-image:latest
          restartPolicy: OnFailure

主要区别：

• 使用标准的5字段 cron 语法
• 运行容器而非脚本
• 有额外字段如 concurrencyPolicy
• 时区由集群/命名空间设置控制

查看 Kubernetes CronJob 示例 →

AWS EventBridge 使用 6字段 cron 表达式，多了一个秒字段：

cron(分钟 小时 日期 月份 星期 年份)

示例：

• 每天下午2点：cron(0 14 * * ? *)
• 每5分钟：cron(0/5 * * * ? *)
• 工作日上午9点：cron(0 9 ? * MON-FRI *)

特别说明：

• 日期或星期字段使用 ? 而非 *
• 支持 L（最后）、W（工作日）和 # 字符
• 所有时间为 UTC

GitHub Actions 在 YAML 中使用标准的5字段 cron 语法：

on:
  schedule:
    - cron: '0 0 * * *'  # 每天UTC午夜

重要说明：

• 仅 UTC：所有时间都是 UTC 时区
• 最小间隔：每5分钟（不是每分钟）
• 不保证执行：高负载时可能延迟
• 需要活跃：仓库60天无活动会被禁用

示例工作流：

name: 每日构建
on:
  schedule:
    - cron: '0 2 * * *'  # UTC 凌晨2点
  workflow_dispatch:  # 允许手动触发
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: npm run build

方法1：使用宿主机 cron（最简单）

0 2 * * * docker exec my-container /app/backup.sh

方法2：在容器中安装 cron

# Dockerfile
RUN apt-get update && apt-get install -y cron
COPY crontab /etc/cron.d/my-cron
RUN chmod 0644 /etc/cron.d/my-cron
RUN crontab /etc/cron.d/my-cron
CMD ["cron", "-f"]

方法3：使用外部调度器

• Kubernetes CronJob
• AWS ECS 定时任务
• Docker Swarm + cron 服务

最佳实践：保持容器无状态，使用外部调度器。

Serverless 平台有自己的调度机制：

AWS Lambda：

• 使用 EventBridge（CloudWatch Events）
• Cron 或 rate 表达式
• 示例：rate(5 minutes) 或 cron(0 12 * * ? *)

Vercel Cron Jobs：

// vercel.json
{
  "crons": [{
    "path": "/api/cron",
    "schedule": "0 0 * * *"
  }]
}

Netlify 定时函数：

// netlify.toml
[[functions]]
  name = "scheduled-function"
  schedule = "@daily"

Google Cloud Functions：

• 使用 Cloud Scheduler
• 标准 cron 语法