> 本文整理自平台文档 docs/wujies/1.x/advanced/catalog-and-edition.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-e1effbfbd7ed-cover.svg)
这一页讲 wujies-app-market 里两个部署拓扑开关的语义、互相约束与失败表现:
| 开关 | 谁读它 | 它决定什么 |
|---|---|---|
app-market.catalog.mode | LocalAppCatalogService / RemoteAppCatalogService(@ConditionalOnProperty 二选一) | 目录(应用 / 版本 / 分类)从本机库读,还是从另一台部署读 |
app-market.edition | MarketEdition | 这套部署是官方版(含上架端)还是用户版(不含上架端) |
两者互相牵制:edition=client 必须配 catalog.mode=remote,否则启动直接失败。组合错了有两种坏结果 —— 起不来,或者更糟的看着成功、实际无效(在用户版的上架端"上架成功",而安装读的是远端目录)。
要装这样的多套部署(1Panel 包、端口、令牌分发、链路验证)见 [/deploy/multi-deployment](/docs/wujies/1.x/deploy/multi-deployment);每一项配置的默认值与环境变量名见 [/deploy/configuration](/docs/wujies/1.x/deploy/configuration) 与 [/reference/config](/docs/wujies/1.x/reference/config);本页讲的是代码里为什么这么写、改哪一行会坏什么。
一、目录中心化(app-market.catalog.mode)
### 1.1 前提:三类数据必须先分家
三种数据混在同一套表里,才会出现"多部署一套系统,上架一次要同步 N 遍"。它们的边界是表上有没有 tenant_id,判据落在两处:DDL 在 wujies-platform/script/sql/update/app_market.sql,全局表白名单在 wujies-platform/wujies-admin/src/main/resources/application.yml 的 security.tenant.excludes。
| 类别 | 表 | 应处位置 | 依据 |
|---|---|---|---|
| 目录 | app_info、app_version、app_category、app_dependency、app_plan、app_version_menu | 中心一份(多部署时可远程读) | 表上没有 tenant_id,已列入 security.tenant.excludes |
| 安装实例 | app_install、app_install_task | 每套部署各一份 | 表上有 tenant_id,不在 excludes 里,由多租户插件隔离 |
| 迁移账本 | app_schema_history | 每套部署各一份 | 同上;唯一键是 (app_code, script),见 [/advanced/lifecycle](/docs/wujies/1.x/advanced/lifecycle) |
因为目录这几张表不带租户参数,目录接口 /app/catalog/ 的请求里不需要传租户** —— 这是整件事能干净做掉的原因,也是"目录能被搬到另一台机器"的全部前提。表间关系见 [/design/data-model](/docs/wujies/1.x/design/data-model)。
它是"版本 → 菜单"的映射,属于目录的一部分(部署内共享)。租户维度的过滤不靠多租户插件,而是 SQL 自己带条件:AppVersionMenuMapper.selectInvisibleMenuIds(tenantId),消费方是 AppMenuFilterImpl。菜单归属本身的规则见 [/advanced/menu-ownership](/docs/wujies/1.x/advanced/menu-ownership)。
### 1.2 唯一入口:IAppCatalogService
安装侧的代码只允许通过它读目录,不要直接注入 AppInfoMapper / AppVersionMapper。接口是"按业务语义取用"而不是"把 Mapper 包一层",所以远程实现只用 URL + 参数就能做出来,不必把 LambdaQueryWrapper 这种本地 ORM 概念漏到远端。
契约共 9 个方法(wujies-platform/wujies-modules/wujies-app-market/src/main/java/cn/wujies/appmarket/catalog/IAppCatalogService.java),每个都有真实消费方:
| 方法 | 语义 | 消费方(都在 appmarket/ 下) |
|---|---|---|
requireOnShelf(appCode) | 取已上架应用,未上架即抛异常 | service/impl/AppInstallServiceImpl(安装入口) |
requireApp(appId) | 按 ID 取应用 | AppInstallServiceImpl、service/AppPackageDeployService、controller/AppRuntimeController |
appsByIds(appIds) | 批量取应用(列表展示补齐,缺的不返回) | AppInstallServiceImpl |
requireVersion(versionId) | 取指定版本 | AppPackageDeployService、spi/impl/PluginAppInstaller、controller/AppInstallController、controller/AppRuntimeController、AppInstallServiceImpl |
requireLatestVersion(appId) | 取该应用最新已发布版本 | AppInstallServiceImpl |
countOnShelf() | 已上架数量(为 0 时菜单过滤可短路) | service/impl/AppMenuFilterImpl.enabled() |
searchOnShelf(keyword, categoryId, audience, limit) | 市场列表(按可见范围筛选) | controller/AppMarketController.list |
findApp(appCode) | 按编码取,不校验上架状态,找不到返回 null | AppMarketController.detail、service/AppRouteHintResolver |
releasedVersions(appId) | 已发布版本列表(草稿/弃用不暴露) | AppMarketController.versions、service/AppPurgeService |
AppPackageDeployService.deploy(...) 里的两处调用是"这条规矩的主路径":以前它直接 selectById 读 app_version / app_info,远程模式下本地没有目录数据,安装会在"下载并落位"这一步报"版本不存在"。
判断标准是一句话:这段代码会跑在别人的部署上吗?
- 会(安装 / 升级 / 市场页 / 卸载 / 运行时答复)→ 必须走目录接口;
- 不会(上架端与控制台就是目录的所有者)→ 直接用 Mapper 是正常的。实际这么做的有
controller/AppConsoleController、controller/AppVersionController、controller/AppPackageController、security/SignatureReadinessService(签名就绪度要按状态查全部版本,目录接口没有也不需要这种查询)。
AppInstallServiceImpl 里仍声明着 appInfoMapper / appVersionMapper 两个字段,但已经没有任何调用(目录读取全部走 appCatalogService,见该类 574 行附近的注释);AppPackageDeployService 顶部也留着这两个 Mapper 的 import。它们不影响行为,只是改造期的残留。
### 1.3 两种实现怎么二选一
remote 与 local 用 @ConditionalOnProperty 二选一,刻意不用 @ConditionalOnMissingBean —— 后者依赖 bean 定义的先后顺序,换个扫描顺序就可能两个都在或两个都不在,而条件属性是确定的。
| 实现 | 装配条件 | 行为 |
|---|---|---|
catalog/LocalAppCatalogService | app-market.catalog.mode=local,matchIfMissing = true(不配就是它 |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-e1effbfbd7ed-guide.svg)


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