中国 帮助

任务中心与日志

这一页面向排障:任务记录里的每个字段由谁写入、进度台阶是哪几行代码推出来的、卡死任务由谁收尾、拿到一条失败任务按什么顺序读。 只想知道界面怎么看、先看哪三处:[任务中心怎么用](/docs/wujies/1.x/basics/tasks

任务中心与日志
封面

> 本文整理自平台文档 docs/wujies/1.x/ops/task-center.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-900ecd66b8c6-cover.svg)

这一页面向排障:任务记录里的每个字段由谁写入、进度台阶是哪几行代码推出来的、卡死任务由谁收尾、拿到一条失败任务按什么顺序读。

  • 只想知道界面怎么看、先看哪三处:[任务中心怎么用](/docs/wujies/1.x/basics/tasks)(使用者视角)。
  • 想知道某个动作到底做了什么、顺序为什么是这样:[应用生命周期](/docs/wujies/1.x/advanced/lifecycle)。

记录存在 app_install_task(DDL 与完整字段清单见 [数据库参考](/docs/wujies/1.x/reference/database))。入口是我的应用 → 应用任务(路由 /myapps/task,源码 plus-ui/src/views/appstore/tasks/index.vue),权限沿用 app:install:list。

先分清:哪些失败没有任务记录

任务行由 AppInstallServiceImpl.runTask 插入,而参数校验与状态机前置校验都发生在插入之前。所以有一类失败在任务中心里永远查不到:

失败时机典型文案有任务记录吗
参数校验租户编号与应用编码不能为空无
已在目标状态应用已处于「已启用」状态,无需重复操作无
版本相同当前已是该版本,无需升级: 1.0.1无
状态机前置校验非法的应用状态迁移: enabled -> installing(AppLifecycleStateMachine.transit 抛 IllegalStateException)无
动作执行中或之后写在 error_msg 里的服务端异常文本有,status=failed

判据是代码里的先后顺序:AppInstallServiceImpl.runTask 先算 successPathOf、逐跳过 AppLifecycleStateMachine.transit,全部通过后才 appInstallTaskMapper.insert(task)。所以「任务中心里没有这条」本身就是一条信息 —— 它说明请求没走到动作执行。

接口同步抛异常时前端拿不到 taskId(例如后端插件未加载就拒绝安装)。但任务行在动作执行之前就已落库,所以失败弹窗会把你送去「应用任务」。见 [在部署里使用应用](/docs/wujies/1.x/basics/using-apps)。

字段:谁写的、排障时看它干什么

字段写入者排障时看它
task_id雪花 ID(MyBatis-Plus ASSIGN_ID)单调递增,列表按它倒序 = 最新的在最上面(不依赖 start_time,同一秒可能有多条)
install_idrunTask指向 app_install。应用名是事后反查出来的(install_id → app_install.app_id → app_info,走 IAppCatalogService),刻意不写 JOIN,所以安装记录删掉后历史任务仍读得出来
task_type枚举 AppTaskTypeinstall / upgrade / enable / disable / uninstall;枚举里还有 repair / rollback,但 successPathOf 对这两个直接抛 尚未实现的生命周期动作,实际不会产生记录
from_version / to_version调用方传入见下一张表,卸载的 to_version 是 NULL
current_stepAppTaskRecorder.step / 终态回写措辞面向用户,直接对应台阶名;失败时会被改写成「失败」,见下面的 warning
progressAppTaskRecorder.step0–100,只增不减
log_textAppTaskRecorder真正的失败现场。格式见下一节
statusAppTaskStatusrunning / success / failed / canceled(canceled 有枚举、当前没有代码写入)
error_msgmarkFailed / 清扫器服务端异常文本,多数情况下原因就在这一句
start_time / end_timerunTask / markFailed / 清扫器详情里的 durationMs 由它们算:end_time 为空时按「到现在」算,所以运行中的任务也有耗时
tenant_id / create_by / create_time / update_by / update_time实体 extends TenantEntity,由平台自动填充update_time 是超时清扫的判据(见下)

各任务类型的版本两列取值:

任务类型from_versionto_version
installNULL安装的目标版本
upgrade升级前的版本目标版本
enable / disable当前版本当前版本(两列相同)
uninstall当前版本NULL

接口返回的是 VO(AppInstallTaskVo),比实体多 taskTypeLabel / statusLabel / durationMs / appCode / appName / appIcon / appMissing。列表接口不带日志正文 —— toTaskVos 里显式 vo.setLogText(null),日志只在详情接口返回(一条日志以 KB 计,一页几十条就是几 MB)。

appMissing=true 说明反查不到应用名(安装记录已被「彻底删除」物理删掉,而任务记录刻意保留当审计线索),列表里显示「(应用已删除)」。

进度台阶:每一步是谁写的

进度由 AppTaskRecorder.step(名称, 进度) 推进,调用点固定在这几处:

进度current_step 的写法写入者
10执行安装 / 执行升级 / 执行卸载…("执行" + taskType.getLabel())AppInstallServiceImpl.runTask
20从应用市场拉取安装包PluginAppInstaller.ensureArtifactsInstalled
30执行版本迁移脚本PluginAppInstaller.applyMigrations
40校验后端产物:<backend 相对路径>;纯前端应用写作 校验后端产物PluginAppInstaller.assertBackendLoaded
60同步菜单与授权PluginAppInstaller.install / upgrade
100完成AppInstallServiceImpl.runTask 成功路径

三条会让人误判的规则:

1. 第 ② 步会整步跳过。同版本重装、且前后端产物都已在磁盘上时,ensureArtifactsInstalled 直接返回,只在日志里记一句「前后端产物均已在磁盘上,跳过拉包(将在迁移脚本之后加载)」。所以进度从 10 直接跳到 30 是正常的,不是丢了步骤。 2. 只有插件型应用有中间台阶。app_type=module 的应用(system / myapps 这类,登记在 script/sql/app_catalog_seed.sql)走 ModuleAppInstaller,里面没有任何 step 调用;启用 / 停用 / 卸载也同理。这些任务只有 10 与 100,过程细节全在 [INFO] 行里 —— 看日志,不要看进度条。 3. 进度只增不减。step(名称) 不带进度时不动 progress;带进度时取 Math.min(100, 进度)。

current_step 的取值只有这么几种:初始 开始;成功 完成;失败 失败(markFailed 覆盖掉原来那一步的名字);超时收尾 超时失败。

也就是说,失败任务的 current_step 里看不到它当时走到哪一步。正确读法是 log_text 里最后一条 步骤 N: … —— 那是最后一次真实进入的步骤。

日志行的格式

AppTaskRecorder 每写一行都会拼上 [HH:mm:ss] 前缀并立刻 updateById,没有节流(步骤数个位数、日志以 KB 计,多一次 UPDATE 的代价远小于「进度卡住不动」):

行的形状谁写的
`[HH:mm

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-900ecd66b8c6-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容