> 本文整理自平台文档 docs/wujies/5.x/platform/app-market/lifecycle.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-9e87828d359f-cover.svg)
这一页讲七个生命周期动作(部署 / 安装 / 升级 / 停用 / 启用 / 卸载 / 彻底删除)在后端各自做了什么、按什么顺序做、失败停在哪一步,以及「彻底删除」为什么会被一道共享闸拦下一半。它面向要改安装或卸载流程的人。
界面上的操作入口与排查速查见 [在部署里使用应用](/docs/wujies/5.x/platform/app-market/using-apps),任务日志怎么读见 [任务中心与日志](/docs/wujies/5.x/deploy/ops/task-center)。
实现全在 wujies-platform/wujies-modules/wujies-app-market/src/main/java/cn/wujies/appmarket/;下面每个结论都标了类名或配置键,可以逐条核对。
编排的收口:一个入口、一张状态机
| 环节 | 类 | 文件 |
|---|---|---|
| 生命周期入口与状态推进 | AppInstallServiceImpl(实现 IAppInstallService) | service/impl/AppInstallServiceImpl.java |
| 合法迁移表 | AppLifecycleStateMachine | state/AppLifecycleStateMachine.java |
| 状态编码与中文名 | AppInstallStatus | enums/AppInstallStatus.java |
| 执行器选择 | AppInstaller.supports() | spi/AppInstaller.java |
| 插件型执行器 | PluginAppInstaller extends ModuleAppInstaller | spi/impl/PluginAppInstaller.java |
| 模块型执行器 | ModuleAppInstaller | spi/impl/ModuleAppInstaller.java |
| 进度边跑边落库 | AppTaskRecorder(ThreadLocal) | support/AppTaskRecorder.java |
| 任务表实体 | AppInstallTask、AppTaskType、AppTaskStatus | domain/、enums/ |
执行器按清单里的 type 选:AppInstallServiceImpl.requireInstaller 用 installer.supports(manifest) 过滤,默认实现就是比 manifest.type 与 installer.type();PluginAppInstaller 重写了 supports(),把 app 和 plugin 一起接走 —— 应用与插件是台账与界面上的分类,落地路径相同。spi/impl/ 下没有 deploy 的执行器,清单写 type: deploy 会报「没有可处理该应用的安装器」。
### 合法迁移表
起点是 app_install.status 的当前值(AppInstallStatus,无记录表示"未安装"):
| 起始状态 | 允许到达 |
|---|---|
| 无记录(未安装) | installing |
installing | installed、failed |
installed | enabled、uninstalling、failed |
enabled | disabled、upgrading、uninstalling、failed |
disabled | enabled、upgrading、uninstalling、failed |
upgrading | enabled、disabled、failed |
failed | installing、upgrading、uninstalling、uninstalled |
uninstalling | uninstalled、failed |
uninstalled | installing |
四条读表时容易忽略的:
- 只有
enabled算"对本租户可见"(AppLifecycleStateMachine.isVisible);installed不可见。 installed只是路径中间态。安装的成功路径是installing → installed → enabled(装完即启用),而successPathOf的终态才落库 —— 所以实际停靠的状态里不会出现installed。- 升级保留原启停状态:路径写成
upgrading → disabled(原本停用)或upgrading → enabled。 - 没有任何状态能直达
uninstalled,必须先过uninstalling。历史上有一次把卸载路径写成[uninstalled],于是disabled → uninstalled直接抛「非法的应用状态迁移」—— 现在所有路径集中在successPathOf一处,就是为了不再各写一份。
### runTask 的三条实现约束
1. 整条路径先校验、后执行:AppInstallServiceImpl.runTask 在插入 app_install_task 之前把成功路径逐跳喂给 AppLifecycleStateMachine.transit。非法就抛「非法的应用状态迁移: …」,而且不产生任务行。 2. "已处于目标状态"只对三类动作生效(goalStatusOf):启用 / 停用 / 卸载。安装与升级刻意不做这个判断 —— 升级一个已停用的应用时路径终态恰好等于当前状态(upgrading → disabled),按终态判重会把"已停用的应用升不了级"做成一个死结。 3. 失败必须落库,连 Error 一起捕:markFailed 把 app_install_task.status 置 failed 并写 error_msg,同时把 app_install.status 也置 failed。只捕 RuntimeException 是不够的 —— NoClassDefFoundError、OOM 会让任务永远停在 running(前端看到"一直在跑",其实早就死了),这是实测踩到过的。
任务类型枚举 AppTaskType 里有 repair(修复)与 rollback(回滚),但 successPathOf 对这两个直接抛 UnsupportedOperationException("尚未实现的生命周期动作") —— 它们目前只是预留。
七个动作各自做了什么
| 动作 | 接口(权限) | 后端真实行为 | 状态 |
|---|---|---|---|
| 部署 | POST /app/install/version/{versionId}/deploy(app:install:edit) | 拉包校验 → 落位 → 热加载。不跑迁移脚本,也不改安装记录 | 不动 app_install |
| 安装 | POST /app/install(app:install:add) | 落位 → 迁移 → 断言后端已加载 → 按清单幂等 upsert 菜单 + 授权给本租户管理员角色 | installing → installed → enabled |
| 升级 | POST /app/install/{installId}/upgrade?versionId=(app:install:edit) | 同安装,但强制重新落位;成功后把 app_install.version_id 落成目标版本 | enabled/disabled → upgrading → 原状态 |
| 启用 | POST /app/install/{installId}/enable | 先 load 把后端装回运行时,再补授权 | installed/disabled → enabled |
| 停用 | POST /app/install/{installId}/disable | 只 unload;菜单行与授权都保留 | enabled → disabled |
| 卸载(保留数据,默认) | POST /app/install/{installId}/uninstall(purge 缺省 false) | 撤本租户菜单授权 + unload;菜单行、数据表、迁移记录、本机产物全留 | → uninstalling → uninstalled |
| 彻底删除 | 同一条接口 + ?purge=true | 上面那些 + AppPurgeService.purge()(见下文),最后物理删 app_install 那一行 | 同上 |
接口清单与权限标识见 [HTTP 接口索引](/docs/wujies/5.x/platform/reference/api)。
- 安装请求体只有 `appC
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-9e87828d359f-guide.svg)


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