沙滩星空的博客沙滩星空的博客

安装ruoyi-vue-pro并启动bpm工作流模块

安装并启动ruoyi-vue-pro主框架

  1. 下载项目: git clone -b master-jdk17 git clone https://gitee.com/zhijiantianya/ruoyi-vue-pro.git
  2. 初始化MySQL: 创建名为 ruoyi-vue-pro 的数据库,导入项目 ./sql/mysql 路径下的2个SQL文件。
  3. 配置Redis:本地开放 6379 端口,不设置账号密码。有需要可以修改 application-local.yaml 文件
  4. 编译和打包: mvn clean install package '-Dmaven.test.skip=true'
  5. 启动jar文件: 运行命令:java -jar xxx/xxx/xx.jar, 浏览器访问:http://127.0.0.1:48080
#!/bin/bash

mvn clean install package '-Dmaven.test.skip=true'
# 在后台执行:nohup java -jar ./yudao-server/target/yudao-server.jar > yudao-server.run.log 2>&1 &
# java -jar /home/yourname/.m2/repository/cn/iocoder/boot/yudao-server/2.4.2-SNAPSHOT/yudao-server-2.4.2-SNAPSHOT.jar
java -jar ./yudao-server/target/yudao-server.jar

# 强制更新依赖并重新构建(推荐)
# mvn clean install -U -Dmaven.test.skip=true

# 如果问题仍存在,尝试清理本地仓库缓存
# mvn dependency:purge-local-repository
# mvn clean install -U
  • MySQL 要启动 3306 端口,账号是 root,密码是 123456。不一致,要修改 application-local.yaml 文件。
  • 我本地电脑是 jdk17,故下载 master-jdk17 分支。对应 JDK 17/21 + Spring Boot 3.2 版本
  • 默认情况下,使用 master 分支,它对应 JDK 8 + Spring Boot 2.7 版本
  • 【如果是 PostgreSQLOracleSQL Server】,修改 yudao-spring-boot-starter-mybatis 模块的 pom.xml 文件,将对应的 JDBC Driver 的 optional 移除(注意,需要刷新下 Maven 的依赖)。
  • 编译和打包 Unknown lifecycle phase “.test.skip=true” 错误,使用 mvn clean install package -Dmaven.test.skip=true 即可
  • 刷新依赖:mvn clean install -U -Dmaven.test.skip=true

编译和启动前端

进入 ./yudao-ui/yudao-ui-admin-vue3 目录。发现里面只有一个 README.md 文件,删掉它,因为等下要在这地方,存放克隆下来的前端仓库源码,有文件源码克隆不下来。

  • nodejs > 16.18.0 && pnpm > 8.6.0 (强制使用pnpm)
# sudo apt install nodejs npm
cd ./yudao-ui/yudao-ui-admin-vue3
rm README.md

# 注意最后面那个点.
clone https://github.com/yudaocode/yudao-ui-admin-vue3.git .

# 安装 pnpm,提升依赖的安装速度
npm config set registry https://registry.npmmirror.com
npm install -g pnpm
# 安装依赖
pnpm install

开发调试启动:


# 修改.env.loacl配置文件
# VITE_BASE_URL='http://172.16.160.xx:48080'
vim .env.loacl

# 启动服务
npm run dev -- --port 8000

编译打包到生产环境:

# 修改.env.prod配置文件
# VITE_BASE_URL='http://172.16.160.xx:48080'
vim .env.prod

# 执行编译命令。具体参数查看package.json文件
# 编译成功后,新生成目录:dist-prod
npm run build:prod

# 尝试用python的http.server模块启动静态资源服务器。网页刷新后会报错,这个是正常的。
# 此步骤也可跳过。直接看下一步:部署前端生产环境
cd dist-prod && python3 -m http.server 8000

部署前端生产环境

通过前面编译打包方式,访问 http://yourip:8000 VUE3页面和后续的点击都正常,但是刷新后就找不到服务。

因为Vue Router 使用了 ​​HTML5 History 模式​​(createWebHistory()),而 python3 -m http.server 是一个简单的静态文件服务器,不支持 SPA(单页应用)的路由重定向。当刷新页面时,服务器会尝试查找与 URL 路径匹配的文件,但找不到对应的资源,因此返回 404。解决方式如下:

  1. 修改 vue-router 的配置,将 createWebHistory() 替换为 createWebHashHistory()
  2. 使用支持 SPA 的服务器(如 Nginx)​
  3. 使用 serve 替代 python3 -m http.server

方法一:

// router/index.js
import { createRouter, createWebHashHistory } from 'vue-router'

const router = createRouter({
  history: createWebHashHistory(), // 使用 Hash 模式
  routes: [...]
})

这样 URL 会变成 http://localhost:8000/#/your-route,刷新时不会触发服务器请求,因此不会 404

方法二:

如果必须使用 createWebHistory(),可以改用支持 SPA 的服务器(如 Nginx),并配置 try_files 将所有请求重定向到 index.html:

server {
    listen 8000;
    server_name localhost;
    root /path/to/dist-prod;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

方法三:

npm install -g serve
serve -s /path/to/dist-prod -l 8000

启动工作流模块

1. 第一步,开启模块

① 修改根目录的 pom.xml 文件,取消 yudao-module-bpm 模块的注释。

引入 模块

② 第二步,修改 yudao-serverpom.xml 文件,取消 yudao-module-bpm-biz 依赖的注释,并进行Maven 依赖刷新。

# vim ./yudao-server/pom.xml

<dependency>
    <groupId>cn.iocoder.boot</groupId>
    <artifactId>yudao-module-bpm-biz</artifactId>
    <version>${project.version}</version>
</dependency>

刷新依赖:

# 强制更新依赖并重新构建(推荐)
mvn clean install -U -Dmaven.test.skip=true

# 如果问题仍存在,尝试删除本地缓存的依赖并重新下载
mvn dependency:purge-local-repository
mvn clean install -U

2. 第二步,导入 SQL

点击 bpm-2024-03-24.sql.zip 下载附件,解压出 SQL 文件,然后导入到数据库中。

友情提示:↑↑↑ bpm.sql 是可以点击下载的! ↑↑↑

导入以 bpm_ 作为前缀的表,就是 BPM 模块的表。

3. 第三步,重启项目

重启后端项目,重启项目,看到 Property Source flowable-liquibase-override refreshed 说明开启成功。

mvn实用命令

  • 验证 pom.xml 文件格式 : mvn help:effective-pom -Doutput=effective-pom.xml
  • 检查依赖树是否有冲突 : mvn dependency:tree

项目主页:https://gitee.com/zhijiantianya/ruoyi-vue-pro
快速启动项目:https://doc.iocoder.cn/quick-start/
芋道源码-BPM工作流模块-初始化sql语句-mysql版本 https://download.csdn.net/download/yy3306553/90670022
未经允许不得转载:沙滩星空的博客 » 安装ruoyi-vue-pro并启动bpm工作流模块

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址