ruoyi-plus-5.3.0 开发环境搭建

序号	修订内容	修订时间
1	新增	20250219

一 摘要

主要介绍ruoyi-plus 开发环境搭建，本次以5.3.0 版本为例

二 环境信息

2.1 代码信息

,前端

2.1.1 官方代码地址

后端代码RuoYi-Vue-Plus

前端代码plus-ui

2.1.2 代码版本

个人fork 了官网代码，然后基于
本文是基于后端 v5.3.0 （提交id 296466f ）5 新建了dev-v5.3.0 分支，
前端 v5.3.0-v2.3.0 （提交id b2a4157）新建 dev-v5.3.0 分支 部署开发环境。

2.2 软件信息

序号	软件名称	版本
1	Liberica JDK	21.0.6
2	maven	3.6.2
3	mysql	8.0.39
4	redis	7.4.0
5	minio	7.4.0
6	nvm

2.3 操作系统

整个开发环境是在win 11 上搭建

三 依赖软件安装及启动

3.1 minio 安装及启动

minio 是用于存放上传文件用，可以不部署。
下载minio windows 版本，放入指定目录，编写启动脚本

3.1.1 启动脚本 startminio.bat

新建 startminio.bat 内容如下
`
D:\dev\minio\minio.exe server D:\dev\minio\data --console-address ":9001"

`

3.1.2 管理员启动startminio.bat

D:\dev\minio>D:\dev\minio\minio.exe server D:\dev\minio\data --console-address ":9001"
MinIO Object Storage Server
Copyright: 2015-2025 MinIO, Inc.
License: GNU AGPLv3 - https://www.gnu.org/licenses/agpl-3.0.html
Version: RELEASE.2024-07-29T22-14-52Z (go1.22.5 windows/amd64)

API: http://192.168.128.76:9000  http://2.0.4.66:9000  http://192.168.56.1:9000  http://127.0.0.1:9000
   RootUser: minioadmin
   RootPass: minioadmin

WebUI: http://192.168.128.76:9001 http://2.0.4.66:9001 http://192.168.56.1:9001 http://127.0.0.1:9001
   RootUser: minioadmin
   RootPass: minioadmin

CLI: https://min.io/docs/minio/linux/reference/minio-mc.html#quickstart
   $ mc alias set 'myminio' 'http://192.168.128.76:9000' 'minioadmin' 'minioadmin'

Docs: https://min.io/docs/minio/linux/index.html
WARN: Detected default credentials 'minioadmin:minioadmin', we recommend that you change these values with 'MINIO_ROOT_USER' and 'MINIO_ROOT_PASSWORD' environment variables
INFO:
+---------------------------------------------------------------------------------------+
| You are running an older version of MinIO released 6 months before the latest release |
| Update: Run `mc admin update ALIAS`                                                   |
+---------------------------------------------------------------------------------------+

截图如下

四 运行项目

4.1 后端

4.1.1 启动redis\mysql

因为以设置为开机启动，所以均以启动

4.1.2 启动minio （可以跳过）

不测试文件上传等功能，可以不启动minio

4.1.3 修改jdk 版本

4.1.3.1 修改\RuoYi-Vue-Plus\pom.xml

我们目前配置的是jdk21

 <java.version>21</java.version>

4.1.3.2 刷新maven 依赖

改完jdk 后，需要重新刷新maven 依赖

4.1.3.3 修改ide project Structure jdk 版本

IDE 里 Project Structure 里 Project Settings 里 Project 里jdk 版本需与pom 里jdk 版本一致

4.1.4 确认激活的环境

4.1.4.1 \RuoYi-Vue-Plus\pom.xml 配置文件看激活环境

<activeByDefault>true</activeByDefault> 代表环境被激活，详细配置如下

        <profile>
            <id>dev</id>
            <properties>
                <!-- 环境标识，需要与配置文件的名称相对应 -->
                <profiles.active>dev</profiles.active>
                <logging.level>info</logging.level>
                <monitor.username>ruoyi</monitor.username>
                <monitor.password>123456</monitor.password>
            </properties>
            <activation>
                <!-- 默认环境 -->
                <activeByDefault>true</activeByDefault>
            </activation>
        </profile>

4.1.4.2 idea 里也可以看激活的环境

4.1.5 修改 \RuoYi-Vue-Plus\ruoyi-admin\src\main\resources\application-dev.yml

4.1.5.1 修改数据库配置

数据库的连接地址和账号密码改为你自己安装的数据库地址和账号密码

        # 主库数据源
        master:
          type: ${spring.datasource.type}
          driverClassName: com.mysql.cj.jdbc.Driver
          # jdbc 所有参数配置参考 https://lionli.blog.csdn.net/article/details/122018562
          # rewriteBatchedStatements=true 批处理优化 大幅提升批量插入更新删除性能(对数据库有性能损耗 使用批量操作应考虑性能问题)
          url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
          username: root
          password: 123456

4.1.5.1 修改redis 配置

4.1.5.1.1 redis 连接配置

按redis 安装时设置的密码配置

spring.data:
  redis:
    # 地址
    host: localhost
    # 端口，默认为6379
    port: 6379
    # 数据库索引
    database: 0
    # redis 密码必须配置
    password: ruoyi123
    # 连接超时时间
    timeout: 10s
    # 是否开启ssl
    ssl.enabled: false

4.1.5.1.2 redis 前缀（可选）

# redisson 配置
redisson:
  # redis key前缀
  keyPrefix: ruoyivue

4.1.6 初始化数据

4.1.6.1 建库

字符集 utf8mb4 ，排序规则 utf8mb4_general_ci

4.1.6.2 导入数据

mysql 数据库脚本在如下目录：RuoYi-Vue-Plus\script\sql

分别导入"D:\dev\idea\RuoYi-Vue-Plus\script\sql\ry_vue_5.X.sql" "D:\dev\idea\RuoYi-Vue-Plus\script\sql\ry_job.sql" "D:\dev\idea\RuoYi-Vue-Plus\script\sql\ry_workflow.sql"

能利用工具导入就利用工具导入，当时有cmd 里执行source 报 ERROR 1366 (HY000): Incorrect string value 错误时，
一般是因为cmd 编码格式默认是gbk 导致
具体参考修改cmd控制台默认代码页编码的几种方法【GBK、UTF-8】

需将cmd 编码格式临时改为utf8 即可。
cmd 里执行 chcp 65001，然后登陆数据库 ，再检查编码格式

4.1.7 启动

启动主程序dromaraApplication 即可。

第一次启动 缺少依赖
com.aizuda.snailjob.client.job.core.executor.AbstractJobExecutor;
重启电脑，重新启动 依赖又有了。。。。

4.2 前端

4.2.1 安装nvm

4.2.2 使用nvm 安装node

4.2.3 使用node 18

PS D:\dev\vscode\plus-ui> nvm list

    22.12.0
  * 18.20.5 (Currently using 64-bit executable)
PS D:\dev\vscode\plus-ui> nvm use 18
Now using node v18.20.5 (64-bit)
PS D:\dev\vscode\plus-ui> 

4.2.4 启动前端

PS D:\dev\vscode\plus-ui> npm run dev

> ruoyi-vue-plus@5.3.0 dev
> vite serve --mode development

Re-optimizing dependencies because vite config has changed

  VITE v5.4.11  ready in 8849 ms

  ➜  Local:   http://localhost:80/
  ➜  Network: http://192.168.56.1:80/
  ➜  Network: http://192.168.128.76:80/
  ➜  press h + enter to show help

五 参考

5.1 官方参考

官方部署参考