企业官网建设流程全解析

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 的全部功能，开箱即用。用户、角色、部门、菜单、字典、通知公告这些传统系统模块一应俱全，还内置了多租户隔离、WarmFlow 工作流审批、代码生成器、分布式任务调度、OSS 文件存储等进阶能力。简单说，你想快速搭一套企业级管理后台，又不想从零写框架层，选它做底座再写业务代码，能省下大量重复劳动。

技术栈一览

• Spring Boot 4.x：整体骨架，应用启动与自动装配全靠它
• JDK 21：后端最低运行版本，用上了虚拟线程等新特性
• Sa-Token：轻量级权限认证，登录校验、角色与按钮级权限控制
• Mybatis-Plus：ORM 层，几乎不用手写 SQL，附带分页、数据权限等插件
• Redis + Redisson：缓存、分布式锁、限流等分布式能力底座
• WarmFlow：轻量工作流引擎，支撑复杂审批流
• SpringDoc：接口文档自动生成，零注解入侵
• Hutool / Lombok：工具方法与样板代码简化，日常开发提效

动手前的环境检查清单

• ✅JDK 21（java -version确认，低于 21 无法编译）
• ✅Maven 3.8+（仓库自带mvnw包装器，没有 Maven 也能构建）
• ✅MySQL 8.x（默认数据源，其他数据库需自行改配置）
• ✅Redis 6+（登录认证依赖缓存，必装）

分步把项目跑起来

一键拉取代码

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

拉下来就是一个标准多模块 Maven 工程，ruoyi-admin/ 是可执行的主应用模块。

初始化数据库

在 MySQL 中建库并导入脚本，默认配置连的库名是ry-vue：

mysql -uroot -p -e "create database \`ry-vue\` default charset utf8mb4"

然后执行 script/sql/ry_vue.sql（用到审批功能再导入ry_workflow.sql）。表结构和默认账号数据都在脚本里，导入即可。

启动后端服务

修改ruoyi-admin下application-dev.yml中的数据库账号密码为你本机实际值（默认 dev 配置是 root/root），然后：

mvn clean install -DskipTests

首次构建会拉大量依赖，耐心等待。构建成功后启动主应用：

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

看到日志出现启动成功、端口 8080 被监听，后端就算就位了。本项目前端是独立的 plus-ui 工程，仓库内不含前端代码，本文只跑通后端。

跑通了没？这样确认

浏览器访问http://localhost:8080，不再报 404/502 而是有 JSON 响应，说明服务已起。再访问接口文档http://localhost:8080/v3/api-docs，能返回 OpenAPI JSON（或 swagger-ui 页面），RuoYi-Vue-Plus 安装即告完成。用 SQL 脚本里的 admin 账号走登录接口，能拿到 token 就彻底通了。

卡住了先查这里

1. 8080 端口被占用：启动日志报Port 8080 was already in use，改application.yml里的server.port，或停掉占用端口的进程。
2. 数据库连不上：启动即抛Communications link failure，检查 MySQL 是否在跑、ry-vue库是否导入、yml 里的账号密码与useSSL=true参数是否和本机 MySQL 匹配。
3. 依赖下载失败：Maven 拉包报超时/401，优先检查镜像源配置（settings.xml），国内网络建议换成阿里云或腾讯云镜像仓库。
4. JDK 版本不对：编译报invalid target release: 21，说明当前 JDK 低于 21，切换或升级 JDK 后重新构建。

想省事的话，仓库还带了 script/docker/docker-compose.yml，一条命令拉起 MySQL、Redis、MinIO 等全套环境，适合不想本机装依赖的同学。

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