入口:总览 → 系统 →「定时任务」。用于选择已注册的任务处理器,设置执行计划和查看最近执行结果。
创建任务#
- 点击「新建任务」。
- 填写「任务名称」,例如「每日统计整理」。
- 从「任务处理器」下拉框选择已有处理器,确认说明和所属插件。
- 选择 cron 预设或填写六段 cron,查看「接下来执行时间」。
- 按需填写参数与描述,确认是否启用,点击「保存」。
- 在列表核对名称、处理器、cron 和启用状态。
| 字段 | 说明 |
|---|---|
| 任务名称 | 给维护人员识别任务,必填 |
| 任务处理器 | 由内置任务或已启动插件注册,必选 |
| cron | 执行计划,必填且必须可解析 |
| 参数 | 当前记录保存此字段,是否被实际执行处理器读取需由处理器维护人员确认 |
| 描述 | 记录用途、依赖与操作注意事项 |
| 启用 | 是否参与计划执行;不用于取消已经运行的任务 |
处理器为空时安装并启动声明了定时任务的插件,或联系管理员确认内置任务注册。本界面不提供编写处理器功能。
cron 预设#
| 计划 | 表达式 |
|---|---|
| 每分钟 | 0 * * * * ? |
| 每 5 分钟 | 0 0/5 * * * ? |
| 每小时整点 | 0 0 * * * ? |
| 每天 02:00 | 0 0 2 * * ? |
| 每周一 03:00 | 0 0 3 ? * MON |
cron 包含秒字段,与常见五段系统 crontab 不同。时间预览使用服务端当地时间,不能仅根据自己电脑时区推断执行时间;跨时区部署请让维护人员确认服务器时区。无预览时先检查表达式,不要直接保存未知计划。
手动执行与结果核对#
- 点击任务行的播放图标「立即执行」。这是实际运行任务,会产生处理器定义的业务效果。
- 等待后台执行后刷新列表,查看执行次数、上次执行时间和状态。
- 执行中不要连续点击;长任务可能需要稍后重新进入模块才能看到最终状态。
- 失败时阅读消息,再到 日志中心 查询对应时间和处理器。
| 状态 | 含义 |
|---|---|
| 待执行 | 尚无本次执行结果 |
| 执行中 | 处理器正在执行 |
| 成功 | 处理器执行结束且未报告异常 |
| 失败 | 处理器不存在或执行出错 |
成功状态只代表处理器完成,还应按其业务说明核对实际输出。
修改、停用和删除#
铅笔图标修改任务计划,保存后重新核对下一次执行时间。关闭列表中的启用开关停止后续计划执行;已运行的任务不会因此被撤销,「立即执行」仍可能运行停用任务。
删除前确认任务用途和正在执行情况,再点击垃圾桶并确认。列表没有取消运行或恢复已删除任务的入口。周期任务是否按时运行还取决于当前环境调度服务配置,需检查实际执行记录。