定时任务管理
定时任务管理模块允许你在系统中创建和管理基于 Cron 表达式的周期性任务，用于数据同步、报表生成、消息推送等自动化场景。
功能入口
登录管理后台后，点击左侧菜单 系统管理 > 定时任务，进入任务列表页面。页面以表格形式展示所有任务，包含任务名称、任务组、Cron 表达式、状态等字段。
任务列表
任务列表展示所有已配置的定时任务，支持按任务名称和状态筛选。列表操作列提供执行记录、暂停/恢复、立即执行和编辑删除入口。
新增任务
- 在任务列表页右上角，点击 新增 按钮
- 弹出新增任务表单，填写：
- 任务名称（必填）：任务的描述名称，如"每日用户统计"
- 任务组（必填）：任务分组，如
DEFAULT - 调用目标（必填）：Bean 名称（Spring Bean）
- 调用方法（必填）：Bean 中要调用的方法名
- Cron 表达式（必填）：调度时间规则
- 错误策略：立即重试 / 跳过 / 暂停
- 状态：运行 / 暂停
- 点击 确定 完成创建
Cron 表达式
Cron 表达式由 7 个字段组成：秒 分 时 日 月 周 年。常用示例：
| 表达式 | 说明 |
|---|---|
0 0 0 * * ? | 每天凌晨 0 点执行 |
0 */5 * * * ? | 每 5 分钟执行一次 |
0 0 9 * * MON-FRI | 工作日上午 9 点执行 |
0 0 1 1 * ? | 每月 1 号凌晨 1 点执行 |
填写 Cron 表达式后，系统会自动计算并展示最近 5 次执行时间预览。
执行记录
- 在任务列表中找到目标任务，点击操作列的 执行记录 链接
- 进入执行记录页面，展示该任务的历史执行详情
- 每条记录包含：执行时间、耗时、执行结果（成功/失败）、错误信息
- 失败的执行记录会显示详细错误堆栈，便于排查问题
任务控制
| 操作 | 说明 |
|---|---|
| 暂停 | 暂停任务调度，任务停止执行 |
| 恢复 | 恢复已暂停的任务，恢复调度 |
| 立即执行 | 立即触发一次手动执行，不影响原调度计划 |
| 编辑 | 修改任务配置（Cron、目标方法等） |
| 删除 | 删除任务，停止所有调度 |
注意：立即执行仅触发一次，不会改变 Cron 调度计划。如需长期停止，使用暂停操作。
注意事项
- 任务目标必须是 Spring 管理的 Bean
- 调用方法必须是该 Bean 的公共方法
- 任务执行失败后的行为由错误策略决定
- 频繁执行的任务需注意性能影响
相关文档
- 消息中心 — 使用定时任务发送消息