安装并启动ruoyi-vue-pro主框架
- 下载项目:
git clone -b master-jdk17 git clone https://gitee.com/zhijiantianya/ruoyi-vue-pro.git
- 初始化MySQL: 创建名为
ruoyi-vue-pro
的数据库,导入项目./sql/mysql
路径下的2个SQL文件。 - 配置Redis:本地开放
6379
端口,不设置账号密码。有需要可以修改application-local.yaml
文件 - 编译和打包:
mvn clean install package '-Dmaven.test.skip=true'
- 启动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
版本 - 【如果是
PostgreSQL
、Oracle
、SQL 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。解决方式如下:
- 修改
vue-router
的配置,将createWebHistory()
替换为createWebHashHistory()
- 使用支持 SPA 的服务器(如
Nginx
) - 使用 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-server
的 pom.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