RuoYi-Vue-Plus 多租户后台管理系统：完整搭建与避坑指南

RuoYi-Vue-Plus 多租户后台管理系统：完整搭建与避坑指南

【免费下载链接】RuoYi-Vue-Plus多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、WarmFlow、SpringDoc、Hutool、OSS 定期同步项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus

RuoYi-Vue-Plus 是一个重写了 RuoYi-Vue 全部后端业务的多租户后台管理系统，采用插件化模块化结构，针对分布式集群场景做了整体升级，集成 Sa-Token、Mybatis-Plus、WarmFlow、Redisson、Hutool 等组件。这篇文章带你把 RuoYi-Vue-Plus 安装配置从零跑通：从环境准备、数据库导入，到后端启动成功，顺带讲清最容易踩的几个坑。读完你能在本机独立拉起整套后端，并验证登录链路。

动手前，把这几样备齐

本仓库只含后端，前端是单独的官方工程，验证登录链路时再拉它即可。

RuoYi-Vue-Plus 安装配置完整流程

克隆仓库并核对环境

1. 克隆代码并进入根目录：

git clone https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus cd RuoYi-Vue-Plus

2. 核对 JDK 与 Maven 版本：

java -version mvn -version

3. 打开根目录 pom.xml，确认<java.version>21</java.version>，这是当前版本的编译基线，JDK 低于 21 直接过不了编译。

java -version输出显示 21 或更高版本，环境即可用

准备 MySQL 与 Redis

1. 安装 MySQL 8.x，项目自带编排文件 script/docker/docker-compose.yml 用的就是 mysql 8.4 镜像。
2. 安装 Redis 6 及以上，注意开发配置里 Redis 是带密码的，后面要对应上。
3. 创建业务库，字符集必须是 utf8mb4：

mysql -uroot -p -e "create database \`ry-vue\` default character set utf8mb4 collate utf8mb4_general_ci"

mysql与redis-cli都能正常连接，基础环境就绪

导入初始化 SQL

1. 把核心脚本导入 ry-vue 库：

mysql -uroot -p ry-vue < script/sql/ry_vue.sql

2. 需要定时任务或工作流模块时，再分别导入 script/sql/ry_job.sql 和 script/sql/ry_workflow.sql；AI 模块按需导入 ry_ai.sql。
3. 脚本已内置sys_user、sys_role等系统表和演示账号数据，无需手工建表。

导入无报错，且 ry-vue 库中能看到sys_user等表，这一步完成

修改数据源与 Redis 配置

1. 打开 ruoyi-admin/src/main/resources/application-dev.yml，构建时默认激活 dev profile。
2. 找到spring.datasource.dynamic.datasource.master，把 url、username、password 改成你的 MySQL：

url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8 username: root password: 你的数据库密码 # ...其余参数保持原样...

3. 找到spring.data.redis，把 host、port 指到你的 Redis，password 默认写死为 ruoyi123——要么给本机 Redis 设成同一个密码，要么改成你自己的密码值。
4. 服务端口在 ruoyi-admin/src/main/resources/application.yml 的server.port，默认 8080，被占用时在这里改。

配置项与本机 MySQL、Redis 的账号密码完全一致，保存文件

构建并启动后端

1. 在根目录跳过测试打包：

./mvnw clean package -Dmaven.test.skip=true

2. 启动 ruoyi-admin 模块（可执行 jar）：

java -jar ruoyi-admin/target/ruoyi-admin.jar

控制台出现 "Started DromaraApplication in xxx seconds" 即表示后端启动成功

跑起来之后，先做这三件事

1. 后端服务地址：http://localhost:8080（由 application.yml 的server.port决定）。
2. 打开http://localhost:8080/v3/api-docs，能看到接口分组的 JSON 说明 SpringDoc 文档已生效。
3. 完整登录链路：单独克隆官方前端 plus-ui 工程并指向上述后端，能看到登录页、用内置账号admin（默认密码 admin123）登录成功，即链路全通。

卡住了？RuoYi-Vue-Plus 安装配置避坑速查

⚠️ 以下三个问题覆盖了绝大多数首次启动失败的场景：

现象：启动日志报Port 8080 was already in use原因：8080 端口被本机其他服务占用解法：改 application.yml 里server.port到空闲端口，或停掉占用进程

现象：Maven 编译报invalid target release: 21原因：本机 JDK 版本低于 21，该版本已不支持 Java 8解法：安装 JDK 21+，把 JAVA_HOME 指向新 JDK 后重新构建

现象：启动即失败，日志有 Redis 连接或认证异常原因：dev 配置中 Redis 密码固定为 ruoyi123，与本机 Redis 实际密码不一致解法：给本机 Redis 设置同一密码，或修改spring.data.redis.password匹配实际值

接下来看什么

• README.md（框架能力清单与 RuoYi 原生版的差异对照表，适合想先建立功能全貌的人）
• script/docker/（MySQL、Redis、nginx 的 docker-compose 编排，适合想一键拉起整套基础环境的人）
• ruoyi-modules/ruoyi-demo/（Redis 锁、短信、邮件、加密、Excel 等特性的现成用例，适合按图索骥学功能用法的人）
• ruoyi-admin/src/main/resources/application-dev.yml（完整开发环境配置，适合想逐项理解每个配置项的人）

【免费下载链接】RuoYi-Vue-Plus多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、WarmFlow、SpringDoc、Hutool、OSS 定期同步项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus