> 本文整理自平台文档 docs/wujies/5.x/deploy/backend.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-ff4624534ee6-cover.svg)
后端交付物只有一个可运行 jar 加两个可写目录。要在陌生机器上把服务立起来、换版本重启、或查「装完起不来」卡在哪一步,看这页。配置项逐条的含义在 [配置项索引](/docs/wujies/5.x/deploy/configuration),运行期加载与回收机制在 [插件运行时](/docs/wujies/5.x/platform/architecture/plugin-runtime),本页不重复。
目录与产物
三个仓库没有共同 git 根,各自分支各自提交。本页命令都按这个布局写(上游是 RuoYi-Vue-Plus,更名后的模块与路径一律以 wujies-* 为准):
| 仓库 | 目录 | 内容 |
|---|---|---|
| 后端 | wujies-platform/ | Java 17 / Spring Boot 3.5.15 + script/sql/ + deploy/ |
| 插件 | wujies/plugins/wujies-<code>-plugin/ | 一个应用一个仓库:后端 + frontend/ + app.json + migrations/ + 自带 package.ps1 |
| 宿主前端 | wujies-admin/ | Vue 3 / Vite(旧文档称 plus-ui/);产物目录 app-market-dist/ 在它仓库根下 |
后端启动模块是 wujies-platform/wujies-admin/,宿主前端是同上一级的兄弟目录 wujies/wujies-admin/。工作目录错成上一层 wujies/ 时,../wujies-admin/ 会落到工作区根的化石目录 ruoyi/wujies-admin/(里面只剩 app-market-dist/),产物写得进去、宿主读不到。按完整路径判断,别按名字。
后端仓库里没有业务模块:*-api 契约模块为 0 个(2026-09-30 起),也没有 wujies-job / wujies-demo / wujies-generator。业务应用的实体、Mapper、Service、controller、app.json、migrations/ 都在插件仓库里,平台对 cn.wujies.<app>.* 的 Java 引用为 0,所以在这里找不到 mall、gallery 的代码。
启动模块 wujies-platform/wujies-admin/ 的产物路径固定为 wujies-platform/wujies-admin/target/wujies-admin.jar,依赖链不含任何业务应用:插件 jar 与远程应用前端产物都在运行期由应用市场落位到磁盘(见 [应用生命周期](/docs/wujies/5.x/platform/app-market/lifecycle))。「部署后端」这件事因此始终是「放一个 jar,再给它两个可写目录」,也就是 app-market.deploy.plugin-dir(默认 plugins-dist)与 app-market.deploy.frontend-dir(默认 ../wujies-admin/app-market-dist/remote-apps);两个默认值都是相对路径,基准是启动时的工作目录,容器里分别是 /app/plugins-dist 与 /app/remote-apps。
启动时 AppPackageDeployService 打这三行,它们是部署后端的验收点:
[deploy] plugin-dir = <绝对路径>(存在:true)
[deploy] frontend-dir = <绝对路径>(存在:true)
[deploy] 启动工作目录 user.dir = <目录>(两个相对路径都以它为基准)
frontend-dir 那行写着「存在:false」时会多一条 WARN:部署会把它当普通目录建出来,产物落进去但宿主取不到,前端表现为「远程视图不可用」。看到这条别继续装应用,先用环境变量 WUJIES_FRONTEND_DIR 给绝对路径,或把启动目录改对。
编译与打包
& $mvn -B -q compile -DskipTests # 全量编译(根 pom 默认 skipTests=true)
& $mvn -pl wujies-admin -am -B install -DskipTests # 出可运行 jar:改了后端代码必须做这步
本机没把 JDK / Maven 加进 PATH 时先设 $env:JAVA_HOME 与 $mvn 两个变量。日常回路用 compile,出包用 install:运行中的 JVM 锁着 wujies-admin.jar 和插件 jar,此时执行 install 会在写目标文件时失败,还可能让正在跑的 JVM 抛 NoClassDefFoundError(Windows 上尤其明显)。要热更新某个应用,先 compile,再调 POST /app/dev/reload(body {"appCode":"<code>"});要出 jar 就先停服务再 install。
spring.profiles.active 当前在 application.yml 里硬编码为 prod(@profiles.active@ 那行 Maven 过滤占位符已注释掉,构建期不再决定它),根 pom 的 local / dev / prod 只影响 ${profiles.active} 类过滤值。不传参跑 jar 是 prod,本机联调用 -Dspring.profiles.active=dev 覆盖,容器里由 compose 的 SPRING_PROFILES_ACTIVE 给。
application-prod.yml 里的数据库、Redis、MQ 地址与口令全是 ${WUJIES_*} 占位,没有一份真实值(2026-11-05 收干净)。它同时带着 2C2G 机器的线程与连接池收敛值,换到大内存机器上不必改文件,用环境变量覆盖即可。
路线一:主机直跑
工作目录必须是 wujies-platform/,否则两个产物目录全落错地方:
cd wujies-platform
java "-Dloader.path=plugins-dist" "-Dspring.profiles.active=prod" -jar wujies-admin\target\wujies-admin.jar
| 要点 | 依据 |
|---|---|
-D 参数的引号不能省 | PowerShell 会把 -Dloader.path=x 拆成 /path=x,报 ClassNotFoundException: /path=plugins-dist |
工作目录必须是 wujies-platform | 产物目录是相对路径;看启动日志那三行确认 |
插件运行时开关只能走 -D | -Dapp-market.plugin-runtime.enabled=false 才退回旧的共享加载;只写进 yml 得到的是「插件完全不被加载」,因为启动器在 Spring 之前执行、只读系统属性 |
loader.path 只加载该目录根下的 jar,不递归子目录(迁移脚本的 migrations/ 因此不会被误挂)。同一个 appCode 留着两个版本 jar 也不会再把服务打挂:2026-10-02 起启动器与插件运行时都按 plugins-dist/active-plugins.txt 选版本,清单外的 jar 刻意不挂载;清单读不到或为空时不过滤。
残留 jar 不致命,但容易让人误判当前跑的是哪一份。清理前先看后删,Windows 上被占用的 jar 删不掉,先停 JVM:Get-Content plugins-dist\active-plugins.txt 看生效的是哪些,Get-ChildItem plugins-dist\*.jar | Where-Object { -not (Select-String -Path plugins-dist\active-plugins.txt -SimpleMatch $_.Name -Quiet) } 列清单外的。手工拷进来试的 jar 也会出现在这个列表里,删之前自己确认;没有 active-plugins.txt 说明这台机器还没通过应用市场部署过产物,不用清理。
script/prune/start-host.ps1 那套启动与清理脚本已在 d0cc5cd90「配置与脚本做减法」里整目录删除(script/ 现在只剩 docker/ leave/ sql/),上面那条 java 命令就是它做的事。真要取回:git show d0cc5cd90^:script/prune/start-host.ps1 > start-host.ps1,注意它第 60 行 $root = Split-Path $PSScriptRoot -Parent 在 script/prune/ 下推出来的是 wujies-platform/script,不是仓库根。
路线二:镜像
deploy/docker/ 下是四个镜像的构建上下文(Dockerfile + entrypoint + 待 COPY
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-ff4624534ee6-guide.svg)


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