定时任务
标准版及以上商业版功能
校对日期:2026-11-17。需要商业版标准版及以上。
定时任务按设定的时间自动做一件事:启动采集、重建全文索引、重新生成静态页,或者备份模板、上传文件和数据库。 设定一次之后不需要人工值守。社区版和基础版没有这项功能:发布、修改内容时自动生成静态页、更新索引各版本都有, 但重新生成全部静态页、重建索引只能在 系统 → 生成管理 里手动执行。
一、任务列表
进入 系统 → 定时任务。任务按站点分开,列表只显示当前站点的任务;有多个站点时先在右上角切换到要设置的站点。
| 列 | 说明 |
|---|---|
| 名称、类型 | 任务的名称和类型,类型见“任务类型”一节 |
| Cron表达式 | 任务的执行时间,见“执行计划与 Cron 表达式”一节 |
| 是否启用 | 未启用的任务不按时执行,但仍可以 立即执行 |
| 最近执行时间 | 最近一次到点或立即执行的时间 |
| 下次执行时间 | 按 Cron 表达式算出的下一次执行时间;未启用的任务显示 - |
| 执行状态 | 未运行(还没有执行过)、成功、失败、运行中(只有备份类任务会出现) |
每行的 立即执行、查看错误、编辑、删除 见“立即执行、状态与错误”一节。 上方可按名称、ID 查询,点 查询 也用来刷新列表。拖动行首的图标调整列表中的顺序;按某一列排序时不能拖动。
二、任务类型
| 类型 | 作用 | 结果在哪里看 |
|---|---|---|
| 定时采集 | 启动选定的采集任务,等同于在采集管理里点一次 启动 | 内容 → 采集管理 |
| 生成本站索引 | 清空并重建当前站点的全文索引,等同于生成管理里的 更新本站索引 | 系统 → 生成管理 的任务列表 |
| 更新全部静态页 | 重新生成当前站点的全部文章页、栏目页和首页,等同于生成管理里的 全部更新;站点没有开启静态化时不生成任何页面 | 系统 → 生成管理 的任务列表 |
| 模板备份 | 把模板存储点的全部文件打包 | 文件 → 备份管理 的 模板备份 页签 |
| 上传备份 | 把附件存储点的全部文件打包 | 上传备份 页签 |
| 上传增量备份 | 只打包附件存储点相对上一份备份的变化 | 上传增量备份 页签 |
| 数据库备份 | 调用数据库的命令行工具导出整个数据库并打包 | 数据库备份 页签 |
两种执行方式:
- 前三类只负责发起。 到点时把工作交给后台,定时任务随即记为 成功。这里的成功只表示已经发起; 采集、生成本身是否出错,要到采集管理或生成管理的任务列表里看。静态页和索引任务不检查上一次是否做完, 执行间隔短于一次生成所需的时间时,生成管理的任务列表里会排起多个任务;定时采集遇到上一次还没结束时不执行,记为失败。
- 四类备份在专用线程里依次执行。 执行期间状态为 运行中,完成后变为成功或失败。同时到点的几个备份排队执行,排队的也显示运行中。 同一个任务上一次还没结束时,这一次到点直接跳过。
备份类任务不分站点:无论在哪个站点下新增,备份的都是整个系统的模板、上传文件或数据库,不必每个站点各建一份。 备份文件的查看与恢复见备份管理。
数据库备份 只在 application. 的 ujcms. 为 mysql(MariaDB 也填 mysql)、postgresql、kingbase 或 opengauss 时出现在类型列表里。
三、新增任务
- 点 新增。
- 填写下表各项。
- 点 保存。保存后立即按新的计划生效,不需要重启程序。
| 字段 | 说明 |
|---|---|
| 名称 | 必填,最长 150 个字符 |
| 类型 | 必填,新增时默认为 定时采集。改变类型会清空下面的 采集任务、保留份数 |
| 采集任务 | 类型为定时采集时出现,必填,从本站的采集任务中选择 |
| 保留份数 | 备份类任务出现。备份目录里只保留最新的 N 份(手动备份也算在内),更早的自动删除;上传增量备份 则把最早的几份合并为一份,不删除。填 0 或留空为不限,最大 999 |
| 执行计划 | 见下一节。新增时默认为每天 02:00 |
| 是否启用 | 默认开启。关闭后不再按时执行 |
四、执行计划与 Cron 表达式
执行计划 先选频率,再选具体时间,下方显示生成的 Cron 表达式:
| 选项 | 再选择 | 例子 |
|---|---|---|
| 每小时 | 第几分钟 | 第 15 分钟:0 15 * * * ? |
| 每天 | 时间 | 02:00:0 0 2 * * ? |
| 每周 | 星期几和时间 | 周一 03:30:0 30 3 ? * MON |
| 每月 | 几日和时间 | 1 日 04:00:0 0 4 1 * ? |
| 自定义 | 直接填写 Cron 表达式 | 见下文 |
编辑已有任务时,表达式不属于前四种的,显示为 自定义。
Cron 表达式采用 Quartz 的写法,用空格分成 6 段,从左到右依次为:秒 分 时 日 月 周(可以再加第 7 段年份)。与 Linux crontab 不同的地方:
- 第一段是秒,一般填
0。Linux crontab 的 5 段写法(如0 2 * * *)不能用。 - “日”和“周”两段必须有一段写
?。0 0 2 * * *不能保存,要写成0 0 2 * * ?。 - “周”可以写
MON~SUN,也可以写数字 1~7,但 1 是星期日、7 是星期六。
| 表达式 | 含义 |
|---|---|
0 0/30 * * * ? | 每 30 分钟(整点和半点) |
0 0 0/2 * * ? | 每 2 小时,在整点执行 |
0 0 2,14 * * ? | 每天 2:00 和 14:00 |
0 30 1 ? * MON-FRI | 周一至周五 1:30 |
0 0 3 L * ? | 每月最后一天 3:00 |
0 0 4 ? * SAT#1 | 每月第一个星期六 4:00 |
填写后离开输入框即校验,写法不对时提示“Cron表达式不正确”。
- 时区:按服务器上 Java 进程的时区计算。Docker 镜像已设为
Asia/Shanghai;Jar、Tomcat 部署使用服务器的系统时区, 也可以在启动参数里加-Duser.。timezone= Asia/ Shanghai - 错过的不补做:到点时程序没有运行(停机、正在重启),这一次不补做,等下一次到点。
五、立即执行、状态与错误
- 立即执行:确认“确定立即执行该任务吗?”后马上执行一次,未启用的任务也可以。前三类发起后即记为成功; 备份类变为 运行中,备份完成后点 查询 刷新列表查看结果。备份类任务运行中时这个按钮不可点。
- 查看错误:执行失败后可点,显示的是程序的异常信息,开头一行是原因。下一次执行成功后错误信息清除。
- 程序重启:备份执行期间程序重启,备份中断,重启后这个任务记为失败,错误信息为“应用重启,执行被中断”。
- 删除:只删除任务本身,已经生成的静态页、索引和备份文件不受影响。
- 删除站点时,它的定时任务一并删除;删除用户时,这个用户新增的定时任务也一并删除。
- 静态页、索引任务在生成管理的任务列表里显示为“更新全部静态页”“生成本站索引”,操作人是新增这个定时任务的用户。
六、集群部署
定时任务由 Quartz 调度,默认是内存调度模式。多个节点时:
- 每个节点都会执行同一个任务:静态页在各节点重复生成,索引在各节点重复重建,各节点各自写一份备份。定时采集通过数据库中的状态避免了重复执行。
- 新增或修改任务只在保存它的节点上立即生效,其它节点重启后才按新的设置调度;在这之前,改了执行计划的任务在其它节点仍按旧的时间执行。 停用和删除在各节点都生效:到点时任务已停用或已不存在,就不执行。
需要一个任务只在一个节点上执行时,按集群部署的“Quartz 集群调度”一节切换为数据库调度并开启集群模式。 切换后备份文件写在执行任务的那个节点上,保留份数 也只清理该节点的备份目录, 见集群部署的“本地目录与节点依赖”一节。
七、权限
在 用户 → 角色管理 的权限树里,系统 下的 定时任务 节点有 列表、新增、编辑、删除、立即执行 五项。 查看错误 需要 编辑 或 立即执行 其中一项;拖动排序需要 编辑。
八、常见问题
- 类型列表里没有“数据库备份”。
ujcms.不是database-type mysql、postgresql、kingbase、opengauss之一,见“任务类型”一节。 已有的数据库备份任务在这种情况下保存或执行,会提示“当前数据库类型不支持备份:…”。 - 保存时提示“Cron表达式不正确”。 常见的是照 Linux crontab 写了 5 段,或“日”和“周”两段都写了
*,见“执行计划与 Cron 表达式”一节。 - 执行状态是成功,静态页或搜索结果却没有更新。 成功只表示已经发起。到 系统 → 生成管理 的任务列表看这次任务的状态,出错时点 详情。 静态页还要确认站点已经开启静态化,见页面静态化的“自动生成与手动生成”一节。
- 定时采集记为失败,错误是“采集任务正在运行中”。 到点时上一次采集还没有结束,这一次不执行。说明执行间隔太密,放宽执行计划。
- 保存定时采集任务时提示“引用数据不存在或不属于当前站点”。 所选采集任务已被删除,或属于其它站点。切换到采集任务所在的站点再新增。
- 数据库备份失败,提示检查数据库命令行工具路径。 程序找不到或无法运行数据库的导出工具(如 MySQL 的
mysqldump、PostgreSQL 的pg_dump), 或者数据库账号权限不足。工具不在系统路径里时,在ujcms.填写工具所在目录;详细原因在程序日志里。database-bin-path - 备份一直显示“运行中”。 文件多、数据库大时备份需要较长时间;几个备份同时到点时依次执行,排在后面的也显示运行中。列表不会自动刷新,点 查询 再看。
- 执行时间与设定的差了 8 小时。 服务器 Java 进程的时区是 UTC,见“执行计划与 Cron 表达式”一节的时区说明。
- 每月选了 31 日,有的月份没有执行。 没有这一天的月份不执行。要在每月最后一天执行,用 自定义 写
0 0 3 L * ?这样的表达式。 - 集群里静态页重复生成,或每个节点都有一份备份。 仍是内存调度模式,见“集群部署”一节。