若依框架二次开发 - 前后端分离版
简介
RuoYi-Vue 是一个 Java EE 企业级快速开发平台，基于经典技术组合（Spring Boot、Spring Security、MyBatis、Jwt、Vue），内置模块如：部门管理、角色用户、菜单及按钮授权、数据权限、系统参数、日志管理、代码生成等。在线定时任务配置；支持集群，支持多数据源，支持分布式事务。
以上是来自若依官网的一段简介。
若依官网：http://ruoyi.vip
演示地址：http://vue.ruoyi.vip
代码下载：https://gitee.com/y_project/RuoYi-Vue
环境搭建
可以考虑把 Redis 和 MySQL 环境部署在 Docker 或虚拟机中，这样可以保持物理机干净整洁。
IDE
JetBrains IDEA 或 VSCode，本文均使用 IDEA。
如果您是在校大学生，使用教育邮箱可以申请免费使用教育版。
JDK
JDK >= 1.8
如果需要学习如何下载，可以看我的另一篇文章：OpenJDK - LibericaJDK
Maven
Maven >= 3.0
如果需要学习如何搭建环境，可以看这篇文章：Maven 环境搭建
Node
Node >= 12
如果需要学习如何搭建 NVM 环境，看这里：NVM 环境 - Windows
Redis
Redis >= 3
Docker 部署：Docker 部署 Redis
MySQL
MySQL >= 5.7
Docker 部署：Docker 部署 MySQL
VMware 环境（可选）
下载和安装虚拟机软件：安装 VMware Workstation Pro
虚拟机安装 CentOS 7.6：安装 CentOS 7.6 - VMware
CentOS 7.6 安装 Docker：CentOS 7.6 中安装 Docker
安装 Docker 图形化操作界面：Docker 部署 Portainer
开始使用
拉取代码
官方仓库下载：https://gitee.com/y_project/RuoYi-Vue
方法一：直接下载解压
直接打开上方 URL，点击下载即可。
前提是要先登录，否则会弹窗提示：
前往登录，登录后会自动刷新，然后再点击下载。
有个滑动验证码，需要先过验证。
下载完成后解压，直接解压到一个地方存着。
方法二：git clone
找一个存放项目的位置，然后打开命令行。
执行：
1 | |
前提是已经安装好了 git 工具。
方法三：GitHub Desktop
git 的可视化操作工具
选择 URL，填写若依的仓库 URL，选择保存的路径，点“Clone”拉取。
项目
整体结构
数据库
定位文件
先把 sql 文件夹的数据库文件导入到 mysql 数据库中。
quartz 为可选，与任务调度框架有关，需要使用时再导入。
ry_20230706 为必须，若依框架的核心 sql。
可以使用 Navicat 或者 DataGrip 等管理工具导入。
这里使用 DataGrip 演示。
导入
首先，连接 MySQL 数据库。（连接方法参考：传送门）
在连接的数据库上右键，新建一个数据库，如图操作：
名称可以自定义，编码选择：
1 | |
编码部分支持智能补全，可以直接复制粘贴过去。
点击“OK”即创建完成。
接着在新建的数据库上右键，导入 sql 脚本执行。
可以按住 CTRL 键多选，选好后直接点击“OK”。
导入完成后，可以展开看一看：
后端
导入到 IDEA
方法一：直接拖入
把文件夹拖到 IDEA 的 LOGO 上，可以直接打开导入。
方法二：手动打开
有个弹窗，点击信任项目。
修改 Java 配置
如图点击。
添加一个 JDK，如果已经有 SDK 可用，可以用默认的，否则需要手动 指定。
例如，选择 JDK 1.8
然后还有几个地方需要同步改一下。
然后点击底部的“OK”按钮。
修改 Maven 配置（按需）
一般自带的够用了。如果有特别的设置，可以修改为自己的。
首先打开设置
进入 Maven 设置，选择 Use Maven wrapper
点击后面的三个点，选择自己的 Maven（参考：Maven 环境搭建）
顺手把 User settings file 也选一下
Local repository 同理
修改完成的设置
然后左边选择 Maven - Runner，把第一个框框勾上
设置完成。
修改工程配置
文件上传路径修改，按自己的实际情况修改，配置文件路径：
1 | |
修改样例，例如直接放在工程目录下：
修改 mysql 数据库连接信息，配置文件路径：
1 | |
只需将图中打箭头的部分改成自己的就可以。
修改 redis 配置，配置文件路径：
1 | |
修改成自己的就可以。
修改日志路径，配置所在文件：
1 | |
例如，修改成工程目录下：
运行
打开主方法所在文件
点击主方法旁边的小三角形，运行
启动成功
如果有报错，可以尝试重启 IDEA，并执行一下 mvn clean 然后 mvn install。
mvn 的操作如图，直接双击即可执行：
浏览器访问一下测试：
1 | |
后端运行成功。
前端
IDEA 非常强大，可以直接在 IDEA 中再运行一个前端。
后端可以不关闭，保持运行。
运行
展开 ruoyi-ui 目录，在 package.json 上右键，点 Show npm Scripts
得到一个 npm 的菜单
可以按住 npm 三个字母的地方，将菜单拖到右边
这样会更方便操作
打开控制台
进入 ruoyi-ui 文件夹
1 | |
执行：
1 | |
如果比较慢，可以配置镜像源。（参考：NVM 环境 - Windows：配置镜像源）
不出意外的话，前端跑起来了。
可能的意外：高版本 Node 可能会报错。（如果没有报错滑过去这部分就可以）
1 | |
报错原因：
Node 17 版本开始 OpenSSL 3.0 对允许算法和密钥大小增加了严格的限制。
解决方案：
简单粗暴，使用 Node 17 以下的版本。如果想折腾，使用搜索引擎寻找其他解决方案。
换用版本可以参考：NVM 环境 - Windows
IDEA 修改 Node 版本的方法：
首先，进入配置页面
选到 node.exe
看一眼这个是否与上面选好的一致
点击下方的“OK”保存。
然后点一下运行
如果还是报错，就复制错误到浏览器搜索即可。
访问
直接访问，运行成功后也会自动打开跳转。
默认是：
1 | |
控制台也有输出：
默认账号密码：
1 | |
默认已经填写
登录成功
