定时任务

约 5507 字大约 18 分钟

2025-08-11

定时任务管理

本章涉及的所有功能，都仅限开启了全自动的题目。

功能简介

定时任务管理用于系统中自动执行预设任务的管理。
比如自动备份数据、定时发送提醒、定期清理日志等工作，系统都会根据设置的时间周期自动去执行，无需人工干预。
本系统预设了许多定时任务，例如自动补正，自动提交等，下文中会一一讲解。

警告

如无特殊需求，此页面中的任务不需要进行修改。

功能入口

点击左侧菜单：系统管理 > 定时任务

为了方便演示，已把所有任务置为关闭状态，以实际使用情况为准。

列表您可以看到：

任务编号（不需要管）
任务名称
任务组名
调用目标字符串（禁止修改）
cron执行表达式（非专业人士禁止修改）
状态（开启、关闭）
操作

：修改任务

修改任务

：删除任务（一般不需要进行此操作）
：立即执行一次
：任务详情，可以查看详情信息
：调度日志，可以查看曾经运行的信息，必须什么时候运行过，运行多长时间

调度日志

任务详解

一、刷新系统里的token-key看看是否还可用

本任务默认10分钟执行一次：系统中cron执行表达式为“0 0/10 * * * ?”代表每10分钟执行一次。

什么是 Token-Key？

请见：Token 列表

为什么要刷新 Token？

简单来说：为了防止掉线。
在正常访问网站时，如果你长时间不操作，系统会认为你已经离开，为了安全会自动让你下线（Token 失效）。

定时刷新Token 就相当于：

每隔一段时间，假装点了一下系统，告诉它“我还在”；
这样Token就不会过期，你可以继续免登录使用系统。

提示

如果不刷新，Token过期了，就必须重新登录，重新获取一组新的Token和Key。此系统对此情况做了处理，如果要使用的token失效了，会模拟登录，自动刷新最新的token。

刷新 Token 的两个作用

刷新 Token 不只是防止掉线，其实它做了两件事：

模拟操作，防止掉线
- 长时间不操作会导致 Token 过期，系统自动下线。
- 刷新相当于“假装点了一下系统”，告诉它“我还在”。
检查当前 Token 是否仍然可用
- 如果用户在其他地方登录，这里的 Token 也会立刻失效。
- 刷新时会检测可用性，失效的会自动标记为“失效”状态。

Token 失效后，如何恢复？

有两种方式：

方式 1：等系统自动获取最新 Token
系统会定时帮你获取新的 Token 和 Key，等一会儿就能恢复正常。
方式 2：手动点击右侧“获取”按钮
1. 点击后，会自动弹出浏览器。
2. 系统会自动填入账号密码（你只需处理验证码）。
3. 验证通过后自动登录，并获取最新的 Token 和 Key。

系统中的刷新按钮的作用

作用是立即检测当前列表中 Token 的可用性。

平时系统会通过定时任务，每隔一段时间自动判断 Token 是否有效，但这种方式可能存在延迟显示的情况。
当你点击“刷新”时，系统会立刻：

对当前列表中的每个 Token 进行一次可用性检测；
如果 Token 依然有效，状态保持不变；
如果 Token 已失效（例如掉线、被其他设备登录挤掉等情况），会马上将状态更新为“失效”。

这种操作相当于手动触发一次即时检测，让界面状态更加准确及时。

总结

刷新操作 = 防掉线 + 检查可用性
Token 失效了，可以等自动更新，也可以手动获取，手动更快。

二、提交-未处理

此任务是开始执行状态为“未处理”的题目。

状态列表请见：任务状态详解

执行流程

时间检查
- 如果当前时间在 23:00 ~ 08:00 之间，则不执行任务。

因为版权局的网站每天晚上 11 点后会拉闸，我方系统也会同步休眠。

获取未处理题目
- 查询系统中所有状态为 未处理 的题目。
逐个处理
- 先去“生成系统”查询该题目是否存在：
  - 存在：
    - 如果状态为 未支付 → 调用支付接口 → 将题目状态改为 材料生成中
    - 如果状态为 生成中 → 直接将题目状态改为 材料生成中
    - 如果状态为 已完成 → 也会当做生成中状态处理。
  - 不存在：
    - 添加该题目到“生成系统”
    - 支付成功后，将题目状态改为 材料生成中。

详情流程可以看这个图：

三、材料生成中状态

此任务会自动处理所有状态为 材料生成中 的题目，执行逻辑如下：

执行时间判断
- 系统会先检查当前时间是否在 23:00 ~ 08:00 之间。
- 只有在这个时间段内，任务才会自动执行。
筛选目标题目
- 从系统中查找所有 状态为“材料生成中”，并且 开启了全自动模式 的题目列表。
生成完成检查
- 判断该题目的材料是否已经生成完成。
- 如果材料尚未生成完毕，则跳过本次执行。
区分处理类型
- 如果材料生成完成，系统会继续判断该题目是 新提交 还是补正：
- 因为第一次提交，肯定是材料生成中的，但是还有一种情况是补正了还是需要重新生成一份新的，这时候状态也是材料生产中状态。所以我们得必须得判断。
  - 新提交：表示第一次生成材料，直接进入 提交流程。
  - 补正：表示之前已提交过，但因修改或补充需要重新生成材料，进入 补正流程。
执行对应流程
- 新提交 → 走正常提交流程，将材料提交至相关系统。
- 补正 → 走补正提交流程，将更新后的材料提交替换原有版本。

无论是新提交还是补正提交，系统都需要判断情况，大致情况分为以下几种：

详情流程如图：

四、还差验证码

此状态通常与同步最新验证码搭配使用。
当题目状态为还差验证码且开启了全自动模式时，系统会按以下流程自动处理：

1. 执行时间判断

系统首先会判断当前时间是否在 23:00 ~ 08:00 之间。
仅在此时间段内，任务才会自动执行。

2. 筛选任务列表

获取所有 状态为还差验证码 且 开启全自动模式 的题目。

3. 检查必要验证码

系统会检查 著作权人列表中必要的验证码 是否已经填写完整。

为什么是“必要的验证码”？

因为并不是每个人都需要验证码。
例如：当申请人与著作权人是同一人时，不需要额外验证码，系统会在界面中标注此情况。

如果未填写完整 → 本次取消执行，等待下次判断。
如果已填写完整 → 进入下一步。

4. 区分提交类型

补正提交
- 直接修改并保存。
- 无需上传签章页，系统会直接确认提交，然后状态变为已提交。
新提交
- 保存后将状态更新为 等签章页盖章，等待后续签章操作。

五、等签章页盖章

当题目状态为等签章页盖章且开启了全自动模式时，系统会按以下流程自动处理：

1. 依然是执行时间判断

系统首先会判断当前时间是否在 23:00 ~ 08:00 之间。
仅在此时间段内，任务才会自动执行。

2. 筛选任务列表

获取所有 状态为等签章页盖章 且 开启全自动模式 的题目。

3. 检查著作权人类型

系统会判断著作权人列表中是否存在机构。

4. 处理逻辑分支

① 存在机构

检查是否已上传 签章页：

未上传 → 本次执行结束，等待下次检查（状态依然为等签章页盖章）。
已上传 → 系统会自动上传签章页，并自动确认提交，状态更新为已提交。

② 不存在机构，全是自然人

既然这样，那就好说了，系统会根据著作权人列表顺序自动生成签好字的签章页并上传。

上传完成后，自动确认提交，状态更新为已提交。

上传签章页的方法请参考：上传签章页

提交通知

上传签章页，提交完之后，会给带手机号的著作权人发送一个通知，供他随时查询进度，和下载资料。（因为电信不让短信带验证码，所以只对联通和移动用户有效）

如果客户没收到，也可以把这个链接发送给客户，让他自己输入查询：

http://rzzl.kercore.com.cn/course/goPhoneIndex

这个里边的状态跟此系统里边的是同步的，不是跟版权局官网同步的。

补充说明

著作权人但凡涉及机构，必须人工或系统先上传签章页，系统才会继续执行提交流程。如何上传见上传签章页
个人类著作权人则可由系统自动完成签字与签章页生成，节省人工操作时间。

六、已提交

提示

定时任务中，调用此状态的目标字符串为：

postTask.runYtj(24,-1)

您会看到里边有个24，这个代表：每轮循环只会判断距离上次检查时间超过 24 小时的题目。

也就是说：

任务每30分钟会执行一次；
如果某个题目已处于已提交状态，系统会记录当前检查时间；
在接下来的24小时内，该题目将不会再次被检查；
这样做的原因是：待审查状态通常需要一天左右才会可能有新的进展，没必要每30分钟就检查一次，从而避免浪费系统资源。

基于上述，此任务会自动处理所有状态为已提交的题目，执行逻辑如下：

1. 时间与任务筛选

判断当前时间是否符合执行条件（例如 23:00 ~ 08:00）。
获取 已提交 且 开启自动模式 的题目列表。
获取 24 小时内已检查过 的题目列表。

2. 待检查题目过滤

循环所有 已提交 题目；
如果该题目 不在 24 小时内检查过的列表 中 → 进入检查流程；
否则 → 跳过，等待下次执行。

3. 检查流程

检查Token

判断当前账号的 Token 是否可用（Token 的解释及作用见token原理解释）。
如果Token状态失效：
1. 使用账号密码调用登录服务，自动登录并获取最新Token。
2. 登录成功 → 更新 Token 并继续执行。
3. 登录失败（密码错误）→ 终止，并将Token状态标记为 密码错误，防止下次循环重复尝试，直到密码被修正。
如果Token没有失效 → 直接进入下一步。