> 本文整理自平台文档 docs/wujies/5.x/deploy/ops/task-center.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-cd188f710dcc-cover.svg)
这一页面向排障:任务记录里的每个字段由谁写入、进度台阶是哪几行代码推出来的、卡死任务由谁收尾、拿到一条失败任务按什么顺序读。
- 只想知道界面怎么看、先看哪三处:[任务中心怎么用](/docs/wujies/5.x/platform/app-market/tasks)(使用者视角)。
- 想知道某个动作到底做了什么、顺序为什么是这样:[应用生命周期](/docs/wujies/5.x/platform/app-market/lifecycle)。
记录存在 app_install_task(DDL 与完整字段清单见 [数据库参考](/docs/wujies/5.x/platform/reference/database))。入口是我的应用 → 应用任务(路由 /myapps/task,源码 wujies-admin/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/5.x/platform/app-market/using-apps)。
字段:谁写的、排障时看它干什么
| 字段 | 写入者 | 排障时看它 |
|---|---|---|
task_id | 雪花 ID(MyBatis-Plus ASSIGN_ID) | 单调递增,列表按它倒序 = 最新的在最上面(不依赖 start_time,同一秒可能有多条) |
install_id | runTask | 指向 app_install。应用名是事后反查出来的(install_id → app_install.app_id → app_info,走 IAppCatalogService),刻意不写 JOIN,所以安装记录删掉后历史任务仍读得出来 |
task_type | 枚举 AppTaskType | install / upgrade / enable / disable / uninstall;枚举里还有 repair / rollback,但 successPathOf 对这两个直接抛 尚未实现的生命周期动作,实际不会产生记录 |
from_version / to_version | 调用方传入 | 见下一张表,卸载的 to_version 是 NULL |
current_step | AppTaskRecorder.step / 终态回写 | 措辞面向用户,直接对应台阶名;失败时会被改写成「失败」,见下面的 warning |
progress | AppTaskRecorder.step | 0–100,只增不减 |
log_text | AppTaskRecorder | 真正的失败现场。格式见下一节 |
status | AppTaskStatus | running / success / failed / canceled(canceled 有枚举、当前没有代码写入) |
error_msg | markFailed / 清扫器 | 服务端异常文本,多数情况下原因就在这一句 |
start_time / end_time | runTask / markFailed / 清扫器 | 详情里的 durationMs 由它们算:end_time 为空时按「到现在」算,所以运行中的任务也有耗时 |
tenant_id / create_by / create_time / update_by / update_time | 实体 extends TenantEntity,由平台自动填充 | update_time 是超时清扫的判据(见下) |
各任务类型的版本两列取值:
| 任务类型 | from_version | to_version |
|---|---|---|
install | NULL | 安装的目标版本 |
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_market_schema.sql 的 app_info 种子段)走 ModuleAppInstaller,里面没有任何 step 调用;启用 / 停用 / 卸载也同理。这些任务只有 10 与 100,过程细节全在 [INFO] 行里 —— 看日志,不要看进度条。 3. 进度只增不减。step(名称) 不带进度时不动 progress;带进度时取 Math.min(100, 进度)。
current_step 的取值只有这么几种:初始 开始;成功 完成;失败 失败(markFailed 覆盖掉原来那一步的名字);超时收尾 超时失败。
也就是说,失败任务的 current_step 里看不到它当时走到哪一步。正确读法是 log_text 里最后一条 步骤 N: … —— 那是最后一次真实进入的步骤。
日志行的格式
AppTaskRecorder 每写一行都会拼上 [HH:mm:ss] 前缀并立刻 updateById,没有节流(步骤数个位数、日志以
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-cd188f710dcc-guide.svg)


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