1. 概述
1.1 版本
| FineReport版本 | 功能变更 |
|---|---|
| 11.5.13 | 新增定时调度任务运行检测，支持保存/编辑/复制自动预检、任务管理页手动预检，以及检测结果详情面板 |
1.2 功能简介
运行检测为定时调度补充一套统一的运行预检与事后回溯能力：在调度任务真正执行前，提前校验配置、环境、资源、权限等隐患，并主动暴露风险。
它解决的核心痛点是「问题发现太晚」。此前很多调度故障并非无法提前检测，而是只能等任务正式执行失败后才暴露，被动排查、产生大量运维工单。运行检测把这类问题前置拦截。
运行检测重点覆盖以下六类高频故障：
| 故障类型 | 典型现象 |
|---|---|
| 服务器缺少对应字体 | 报表导出出现乱码 |
| FVS 调度环境配置不完善 | Chromium 无法正常启动 |
| 模板中使用 JS 事件 | 定时调度场景下 JS 事件不生效，结果可能与预览不一致 |
| 数据源密码过期 | 直至任务执行时才触发连接失败 |
| 调度绑定的系统用户已离职 | 引发权限及执行异常 |
| 推送邮箱地址配置错误 | 整批报表推送全部失败 |
2. 触发运行检测
运行检测只做风险提示，不阻断任务执行。你可以通过自动检测和手动检测两种方式触发。
注1：升级到 11.5.13 后，历史存量调度任务的检测状态统一置为「未检测」，需新建任务、复制任务或手动触发后才会重新生成检测状态。
注2：单次只执行一个任务的检查，其余任务排队等待；任务池上限为 30 个，超出时提示「任务排队运行检测中」。
2.1 自动检测（保存 / 编辑 / 复制时触发）
自动检测用于在日常配置过程中即时发现问题，无需额外操作。触发时机与特点如下：
1）在「管理系统>定时调度>任务管理」中添加、编辑或复制任务并保存时，系统自动触发一次检测。
2）检测过程不影响你继续操作，结果会刷新到对应任务的「检测状态」列。
2.2 手动检测（任务管理页触发）
当你需要对某个任务做一次完整校验时，使用手动检测。手动检测会执行全部检查项，逐项校验，通常在 1 分钟内完成。操作步骤如下：
1）进入「管理系统>定时调度>任务管理」。
2）在目标任务操作列中，找到运行检测图标。单击该图标触发检测，图标变为加载状态。
3）检测完成后，本行「检测状态」列自动刷新为最新结果。
3. 查看检测状态与结果
3.1 检测状态说明
每个任务在「检测状态」列展示一个状态。各状态含义与建议动作如下：
| 检测状态 | 含义 | 建议动作 |
|---|---|---|
| 检测异常 | 存在至少 1 个 ERROR 级别检查项未通过，这些异常会导致任务执行出错 | 正式执行前强烈建议先处理 |
| 建议检查 | 无 ERROR，但存在 WARNING 级别问题（如字体缺失）。任务可执行，但结果质量可能受影响 | 建议确认影响后再执行 |
| 已通过 | 所有检查项均通过，由最近一次手动（完整）检测通过后写入，有效期 48 小时 | 无需处理，超过 48 小时自动恢复「未检测」 |
| 检测中 | 手动或自动检测正在执行 | 等待检测完成 |
| 未检测 | 尚未检测，或「已通过」超过 48 小时、其余状态超过约 30 天后自动恢复至此 | 可手动触发一次检测 |
| 检测失败 | 检测过程本身执行失败，失败原因写入检查结果 | 参考提示信息后重新检测 |
注：检测状态具有有效期。「已通过」有效期为 48 小时，超期后恢复为「未检测」；其余状态在约 30 天后也会恢复为「未检测」，以避免检测结果长期堆积。
3.2 检查结果详情面板
单击任意任务的「检测状态」图标，弹出「运行检测结果」面板，用于查看本次检测的完整明细。面板包含：
1）本次检测的触发时间与执行耗时。
2）异常项与警告项的数量统计。
3）检查项清单，每条包含四个字段：异常级别（level）、位置（location）、问题描述（description）、处理建议（suggestion）。
面板底部提供两个操作：
1）单击「重新检测」，对该任务再次触发一次手动检测。
2）单击「前往修复」，跳转到该任务的编辑页进行修复。
上一篇：定时调度任务管理
