前后端项目的更新与启动
1.初次加载
见:https://zentao.jdd001.top/index.php?m=doc&f=view&docID=2
2.远端内容更新时的启动
当有内容更新时的启动,是我们最常用的功能,期间会有一些错误,根据不同的类型查看下面的指引
2.1 基础环境确认
- GDK版本是否匹配
- JAVA环境是否正常,查看java和javac的版本
PS D:\Project\digital-platform> java -version
java version "1.8.0_202"
Java(TM) SE Runtime Environment (build 1.8.0_202-b08)
Java HotSpot(TM) 64-Bit Server VM (build 25.202-b08, mixed mode)
PS D:\Project\digital-platform> javac -version
javac 1.8.0_202
- maven是否正常,注意第4行的提示,一定要是jdk的路径,而不要是jre的路径,如下的jdk后面jre是没问题的
PS D:\Project\digital-platform> mvn -version
Apache Maven 3.9.11 (3e54c93a704957b63ee3494413a2b544fd3d825b)
Maven home: D:\maven
Java version: 1.8.0_202, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jdk1.8.0_202\jre
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
2.2 更新代码后的启动
第1步 拉取代码
分别拉取前后端代码,可以选择自己喜欢的方式获取最新的代码
这里写一个通过命令行的合并当前分支的示例
git fetch --获取最新的分支信息
git merge origin/develop --把远端分支合并到当前分支,有冲突就去解决
真实示例
PS D:\Project\e-mall-manager> git fetch
From ssh://git.linkgie.com:6022/galaxy-apps/e-mall-manager
1c0960d69..027cfcf37 develop -> origin/develop
01e802190..2ccfe11e3 feature/eam -> origin/feature/eam
* [new branch] feature/houyangyu-eam -> origin/feature/houyangyu-eam
6658717ec..1caa21801 feature/luyongqian -> origin/feature/luyongqian
1c0960d69..7258c78ac feature/pms -> origin/feature/pms
32843c0b6..c77325a10 feature/rkswork-doctor -> origin/feature/rkswork-doctor
* [new branch] feature/valet-orders-lgy -> origin/feature/valet-orders-lgy
PS D:\Project\e-mall-manager> git merge origin/feature/luyongqian
Auto-merging e-pms/e-pms-web/src/main/java/com/linkgie/galaxyapps/pms/web/order/PurchaseSchemaOrderItemVO.java
CONFLICT (content): Merge conflict in e-pms/e-pms-web/src/main/java/com/linkgie/galaxyapps/pms/web/order/PurchaseSchemaOrderItemVO.java
Automatic merge failed; fix conflicts and then commit the result.
第2步 停止运行的后端程序
如图有2种方式,顶部的停止按钮和直接删除终端都可以,也可以先不停止尝试是正常
第3步 编译启动(重点)
**90%以上的问题都出现在这一步,以下会详细说明如何操作和错误排查,用到命令其实就3个 **mvn package install -U
mvn clean package -U
npm run serve
2.3.1 前端的启动
命令行窗口路径指向到前端文件根目录下,前2步非必须,根据情况来定
- 确认nodejs版本需要是20.19.0
- npm i
- npm run serve
2.3.2 后端的编译与启动
1.e-mall-manager的编译
日常开发中一般只需要拉取代码即可,不需要做任何动作,这里的情况是没有引入新的包或者GDK没有更新
仅需要一步** 终端进入到e-mall-manager 的根目录路径**
执行 mvn package install -U 命令,目的是看后端的编译是否成功,成功后会出现BUILD SUCCESS,如果成了就不用后续步骤了
mvn package install -U
...代表其他日志
[INFO] e-wms-web .......................................... SUCCESS [ 0.313 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 20.602 s
[INFO] Finished at: 2025-09-03T07:34:03+08:00
[INFO] ------------------------------------------------------------------------
PS D:\Project\e-mall-manager>
错误的排查
情况一,缓存问题,清理工作空间
2.digital-platform的编译
命令行工具进入到digital-platform\digital-platform-server根目录,执行 mvn clean package -U,这里有2个步骤,1.更新后端的依赖包,2.编译前端,并且把dist目录指向到digital-platform-server的前端页面的执行路径下
后端编译成功的标识
[INFO]
[INFO] --- exec:3.2.0:exec (exec-npm-install) @ digital-platform-server ---
up to date in 991ms
51 packages are looking for funding
前端编译成功的标识
[WARNING] Parameter 'optimize' (user property 'maven.compiler.optimize') is deprecated: This property is a no-op in javac.
[INFO] No sources to compile
[INFO]
[INFO] --- surefire:3.5.3:test (default-test) @ digital-platform-server ---
[INFO] No tests to run.
[INFO]
[INFO] --- galaxy-app:2.8.28.RELEASE:package (default-package) @ digital-platform-server ---
[INFO] Building jar: D:\Project\digital-platform\digital-platform-server\target\com.linkgie.galaxyapps.digital#digital-platform-server@2.7.0-SNAPSHOT.zip
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 59.314 s
[INFO] Finished at: 2025-09-03T08:08:33+08:00
[INFO] ------------------------------------------------------------------------
这里有个易错的点,就是他会对前端的dist文件进行操作,然后报错信息还不明显
错误排查
情况一,缓存问题,清理工作空间 同e-mall-manager的处理里方式
情况二,dist文件问题,这里重新加载digital-platform即可
3.digital-platform的启动
由于入口都移入了digital-platform,所以前后端统一在这里启动
后端的启动
找到digital-platform\digital-platform-server下的如图文件,点击debug启动后端,异常情况参考上述说明
前端的启动
参考2.3.1,前端的启动