中国 帮助

后端部署

本页只讲后端:wujiesadmin.jar 怎么打出来、三种起法(主机直跑 / 手工 Docker / 1Panel 本地应用)各敲什么命令、首次启动的初始化 SQL 由谁跑、中间件地址从哪来。 运行期的机制不在这里重复:平台形态(官方

后端部署
封面

> 本文整理自平台文档 docs/wujies/1.x/deploy/backend.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-2909ab3d9dd9-cover.svg)

本页只讲后端:wujies-admin.jar 怎么打出来、三种起法(主机直跑 / 手工 Docker / 1Panel 本地应用)各敲什么命令、首次启动的初始化 SQL 由谁跑、中间件地址从哪来。

运行期的机制不在这里重复:平台形态(官方版 / 用户版)与目录集中见 [/advanced/catalog-and-edition](/docs/wujies/1.x/advanced/catalog-and-edition),插件的加载与回收见 [/advanced/plugin-runtime](/docs/wujies/1.x/advanced/plugin-runtime),app-market: 配置项逐条说明见 [/deploy/configuration](/docs/wujies/1.x/deploy/configuration)。

先认清三个目录

三个仓库没有共同 git 根,各自分支、各自提交。本页所有命令都按这个布局写(平台的上游出处是 RuoYi-Vue-Plus,更名后的模块与路径一律以 wujies-* 为准):

仓库目录内容
后端wujies-platform/Java / Spring Boot + script/sql/ + deploy/
插件wujies/wujies-plugins/插件本体 + 插件前端工程 + package.ps1
宿主前端plus-ui/Vue 3 / Vite —— ⚠️ 它的 package.json 里 name 写的是 wujies-admin,别被这个名字带偏

平台里没有 *-api 契约模块(2026-09-30 起为 0 个),也没有 wujies-job / wujies-demo / wujies-generator。每个业务应用都是自包含的:实体 / BO / VO / Mapper 接口与 Mapper XML / Service / controller / app.json / migrations/ 全在插件仓库的 wujies-<app>/ 下,平台对 cn.wujies.<app>.* 的 Java 引用为 0。所以在这里找不到 mall / gallery 之类的业务代码,这是设计如此 —— 不变量见 [/plugin-dev/basics/invariants](/docs/wujies/1.x/plugin-dev/basics/invariants)。

后端产物:一个可运行 jar

启动模块是 wujies-platform/wujies-admin/,产物固定为:

wujies-platform/wujies-admin/target/wujies-admin.jar

它的依赖链不含任何业务应用:插件 jar 与远程应用前端产物都是运行期由应用市场落位到磁盘的(见 [/advanced/lifecycle](/docs/wujies/1.x/advanced/lifecycle))。所以"部署后端"始终是"部署一个 jar + 给它两个可写目录"。

这两个目录必须记住 —— 在 application.yml 里是相对路径,相对启动时的工作目录:

配置项默认值容器内
app-market.deploy.plugin-dirplugins-dist/app/plugins-dist
app-market.deploy.frontend-dir../wujies-admin/app-market-dist/remote-apps/app/remote-apps

⚠️ 这里的 wujies-admin 是工作区顶层那个只放 app-market-dist/ 的目录(前端产物的落位处),既不是后端模块 wujies-platform/wujies-admin/,也不是宿主前端仓库 plus-ui/——三处同名,按路径判断。

编译与打包

# 环境(本机没有把 JDK / Maven 加进 PATH 时)
$env:JAVA_HOME = "C:\Users\<you>\.jdks\corretto-23.0.2"
$mvn = "C:\Program Files\JetBrains\IntelliJ IDEA 2025.3.3\plugins\maven\lib\maven3\bin\mvn.cmd"

# 全量编译(根 pom 默认 skipTests=true,编译不会跑测试)
& $mvn -B -q compile -DskipTests

# 打可运行 jar —— 改了后端代码必须做这一步才能验证
& $mvn -pl wujies-admin -am -B install -DskipTests
  • install 会把依赖装进本地仓库,运行中的 JVM 会锁住旧 jar:服务还跑着的时候执行它会中途失败(Windows 上尤其明显)。先停服务,或先只做 compile。
  • 跑单模块测试要显式打开跳过开关并指定 profile:& $mvn -pl wujies-modules/wujies-app-market -B test "-DskipTests=false" "-Dprofiles.active=dev"。

### profile 是构建期写进 jar 的,默认是 dev

application.yml 里的 spring.profiles.active: @profiles.active@ 是 Maven 过滤占位符(根 pom 对 application* 开了 filtering),构建时被替换。根 pom 有 local / dev / prod 三个 profile,其中 dev 是 activeByDefault:

构建命令jar 内写死的 profile
mvn -pl wujies-admin -am installdev
mvn -pl wujies-admin -am install -Pprodprod

deploy/tools/build-1panel.ps1 走的是第一条(没有 -Pprod),容器里靠 compose 的 SPRING_PROFILES_ACTIVE: prod 覆盖(环境变量优先级高于 jar 内 yml)。直跑时没有这层覆盖,必须自己传 -Dspring.profiles.active=prod,否则起的是 dev 配置。

⚠️ application-prod.yml 里带着一整套开发验证阶段的连接信息(数据库、Redis、RabbitMQ 的地址与密码都写在文件里)。正式环境必须先按 [/deploy/index](/docs/wujies/1.x/deploy/) 的脱敏清单替换,或用环境变量覆盖。

路线一:主机直跑

工作目录必须是 wujies-platform/(上面两个目录是相对路径):

cd wujies-platform
java "-Dloader.path=plugins-dist" "-Dspring.profiles.active=prod" -jar wujies-admin\target\wujies-admin.jar

四个必须知道的点:

点说明
-Dloader.path 的引号不能省PowerShell 会把 -Dloader.path=x 拆成 /path=x,报 ClassNotFoundException: /path=plugins-dist
工作目录必须是 wujies-platformplugin-dir 与 frontend-dir 都是相对路径;工作目录错了会把产物写到别处
profile 必须显式传见上一节:jar 内默认是 dev
插件运行时开关只能走 -D-Dapp-market.plugin-runtime.enabled=false 才能退回旧的共享类加载器行为;写进 yml 无效——启动器在 Spring 之前执行,读的是系统属性

-Dloader.path 只加载该目录根下的 jar,不递归子目录(所以迁移脚本的 migrations/ 子目录是安全的)。同一个 appCode 名下留着两个版本 jar 也不会再直接把服务打挂:2026-10-02 起启动器与插件运行时都按 active-plugins.txt 选版本,不在清单里的 jar 刻意不挂载;读不到或为空时不过滤,退回改造前的宽容行为。细节见 [/advanced/plugin-runtime](/docs/wujies/1.x/advanced/plugin-runtime)。

### 启动脚本:script/prune/start-host.ps1

推荐用它代替手敲 java:它先清理上一版插件 jar,再按正确的工作目录 / profile / loader.path 启动,jar 不存在时还会自动打包。

章节导览
THE END

喜欢就支持以下吧

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

回到内容