任务中心与日志

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

• 只想知道界面怎么看、先看哪三处：任务中心怎么用（使用者视角）。
• 想知道某个动作到底做了什么、顺序为什么是这样：应用生命周期。

记录存在 app_install_task（DDL 与完整字段清单见 数据库参考）。入口是我的应用 → 应用任务（路由 /myapps/task，源码 plus-ui/src/views/appstore/tasks/index.vue），权限沿用 app:install:list。

先分清：哪些失败没有任务记录复制标题链接

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

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

字段：谁写的、排障时看它干什么复制标题链接

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

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

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

进度台阶：每一步是谁写的复制标题链接

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

三条会让人误判的规则：

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, 进度)。

日志行的格式复制标题链接

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

形状示例（合成，用于说明格式，不是抓取的真实日志）：

[10:00:01] 步骤 1: 执行安装
[10:00:02] 步骤 2: 从应用市场拉取安装包
[10:00:03] [INFO] 已从市场拉取并部署：释放 12 个文件，后端加载=推迟到迁移之后，迁移脚本 1 个
[10:00:04] 步骤 3: 执行版本迁移脚本
[10:00:04] [INFO] 已执行: 01-create-example-tables.sql
[10:00:05] 步骤 4: 校验后端产物：backend/wujies-example-plugin-1.0.0.jar
[10:00:05] [INFO] 后端产物已加载（插件运行时）：wujies-example-plugin-1.0.0.jar
[10:00:06] 步骤 5: 同步菜单与授权
[10:00:07] 安装成功

三条不能改坏的实现约束（改这块代码时别破坏）：

1. ThreadLocal 传递，不改 AppInstaller 的接口签名 —— 安装任务在单线程上同步执行（runTask → action.run(context)），而 AppInstaller 是已对外发布的扩展点契约。
2. 任务结束必须 end()（在 finally 里）。线程池会复用线程，不解绑会让下一个任务把日志写进上一个任务的记录里。
3. 进度上报独立于业务事务。任务失败回滚业务数据时日志必须留下来。

接口与直接查库复制标题链接

浏览器里读不方便时直接查库（表就是 app_install_task）：

-- 某次安装/卸载的全部任务（最新的在最上面）
SELECT task_id, task_type, from_version, to_version, status, progress,
       current_step, error_msg, start_time, end_time, update_time
FROM app_install_task
WHERE install_id = ? ORDER BY task_id DESC;

-- 单条任务的日志正文
SELECT log_text FROM app_install_task WHERE task_id = ?;

界面侧的两个行为（都在 plus-ui/src/views/appstore/tasks/index.vue）：

• 轮询，不是订阅：setInterval(tick, 1500)，且只在「列表里有 running 任务」或「日志抽屉开着且那条是 running」时才真正发请求。想冻住画面逐字读日志，把标题栏的「自动刷新」开关关掉。 ⚠️ 实体 AppInstallTask 的类注释里那句「前端通过 SSE 订阅进度与日志」是旧文案，任务中心没有 SSE 订阅 —— 别照着去找 SSE 接口。
• 运行中的任务不能删，后端会拒绝：任务正在执行中，不能删除。可等它结束，或重启服务后再清理。 删除只删这条执行留痕，不影响应用的安装状态。

卡死任务由超时清扫收尾复制标题链接

任务状态只被两处改写：runTask 的正常/异常路径，以及 AppTaskTimeoutSweeper。进程在任务执行中途被杀（重启、OOM、容器被驱逐）时不会走前者，那条记录会永远停在 running —— 前端显示「一直在跑」，点删除也被拒，而它早就不会再动了。

三个键当前都没有写在 wujies-admin/src/main/resources/application.yml 里，运行时取的是注解兜底值；要改就在 app-market: 下新增 task: 段（改完重启）。三个键的逐项说明见 配置参考。

清扫本身抛异常不会影响调度线程（catch (Throwable) 在 TenantHelper.ignore 外层，吞掉并打 WARN），下一次还会再来。

拿到一条失败任务：按顺序读四处复制标题链接

1. log_text 里最后一条 步骤 N: … —— 真正的卡点（不是 current_step，见上面的 warning）。
2. error_msg —— 服务端异常原文。下表是代码里实际会出现的字符串，可以按它反查来源。
3. 日志尾部的 [WARN] 行 —— 失败前的警告往往已经说明了原因（共享闸跳过了删除、旧产物删不掉、后端产物需重启才生效…）。
4. status + update_time —— failed + current_step='超时失败' 是清扫器写的；running 且 update_time 很久没动说明进程已被打断，等清扫收尾。

真实存在的错误文本（按出处核对）：

按症状查处置（含上面这些错误的下一步动作）在 故障排查；签名相关的处置见 包安全与签名；迁移脚本的规矩见 版本化迁移；插件加载相关的排查见 插件运行时与类加载器。

相关阅读复制标题链接

• 任务中心怎么用 —— 使用者视角：界面每一列、失败先看哪三处
• 故障排查 —— 按症状查原因与处理
• 运维手册 —— 日志文件在哪、日常检查清单、已知限制
• 应用生命周期 —— 七个动作各自做了什么、合法状态迁移
• 数据库参考 —— app_install_task 的 DDL 与索引
• 配置参考 —— app-market.task.* 三个清扫参数