定时任务
2025/7/16大约 1 分钟
GSManager3 项目中的定时任务 CRON 用法介绍
功能概述
定时任务功能是 GSManager3 项目中用于调度自动化操作的模块,主要基于 node-cron 库实现,支持使用 CRON 表达式定义任务执行时间。
功能原理
定时任务系统使用 node-cron 来调度任务,并通过 cron-parser 验证和解析 CRON 表达式。CRON 表达式是一种标准的时间模式字符串,用于指定任务的执行频率,如分钟、小时、天等。
- CRON 表达式格式:
* * * * *
(分别代表:分钟、小时、日、月、周)。*
:表示任意值。,
:分隔多个值(如1,3
表示 1 和 3)。-
:范围(如1-5
表示 1 到 5)。/
:步长(如*/15
表示每 15 单位)。
注意事项
- 无效的 CRON 表达式会抛出错误,如 "无效的cron表达式",请确保表达式符合标准。
- 项目使用 UTC 时区调度任务,如果需要本地时区,请在表达式中调整。
- 过于频繁的 CRON 表达式(如
*/1 * * * *
)可能导致系统资源消耗过高;无效表达式会阻止任务创建,请使用验证工具测试。