🔥 官方推荐 🔥 RuoYi-Vue 全新 Pro 版本，优化重构所有功能。基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 微信小程序，支持 RBAC 动态权限、数据权限、SaaS 多租户、Flowable 工作流、三方登录、支付、短信、商城、CRM、ERP、MES、IM、AI 大模型、IoT 物联网等功能。你的 ⭐️ Star ⭐️，是作者生发的动力！
📊 Project Info
- Language
- Java
- Stars
- ⭐ 37,456
- Forks
- 8,120
- Today
- +34
- Ranking
- #1
- Collection
- Language
- Trending Date
- May 30, 2026
- Last Push
- 5/24/2026
🏷️ Topics
flowablemybatis-plusmysqlredisredissonspring-securityspringbootvue
📸 Screenshots
5分钟快速开始 RuoYi-Vue-Pro
基于 Spring Boot 和 Vue 的全功能后台管理系统，快速部署并体验核心功能。
🖥️ OS
macOSWindowsLinux
⚙️ Runtime
JDK8 或 17/21
Node.js16+
MySQL5.7+
Redis5.0+
🔧 Tools
Git— 克隆项目代码
Maven— 构建 Java 后端
npm 或 yarn— 构建 Vue 前端
📝 Steps
1
克隆项目并准备数据库
下载代码并导入初始 SQL 到 MySQL。
克隆项目到本地
$ git clone https://github.com/YunaiV/ruoyi-vue-pro.git进入项目目录
$ cd ruoyi-vue-pro导入数据库脚本，按提示输入密码
$ mysql -u root -p < sql/ruoyi-vue-pro.sql✓Expected: SQL 导入成功，无错误信息。
💡确保 MySQL 服务已启动，数据库名默认为 ruoyi-vue-pro。
2
配置后端环境
修改配置文件以连接 MySQL 和 Redis。
如果不在项目根目录，先进入
$ cd ruoyi-vue-pro编辑开发环境配置，或使用其他编辑器
$ nano ruoyi-module-system/src/main/resources/application-dev.yml✓Expected: 文件打开后，找到并修改数据库和 Redis 连接信息。
💡主要修改 spring.datasource.url、username、password 和 spring.redis.host、port。
3
启动后端服务
使用 Maven 编译并运行 Spring Boot 应用。
编译项目，跳过测试
$ mvn clean install -DskipTests启动系统模块
$ mvn spring-boot:run -pl ruoyi-module-system✓Expected: 看到 'Started Application in ... seconds' 表示启动成功。
💡默认端口为 8080，确保端口未被占用。
4
启动前端管理后台
构建并运行 Vue 前端（以 Vue3 + element-plus 为例）。
进入前端项目目录
$ cd yudao-ui-admin-vue3安装依赖
$ npm install启动开发服务器
$ npm run dev✓Expected: 服务器启动，输出本地访问地址如 http://localhost:80。
💡如果使用其他前端版本，替换目录名和命令。
✅ 验证成功运行
访问前端界面并登录系统。
- ✓后端控制台无错误日志
- ✓前端页面正常加载
- ✓使用默认账号 admin/admin123 登录成功
⚡ Quick Tips
版本选择使用 JDK 8 选择 master 分支，JDK 17/21 选择 master-jdk17 分支。
配置如果遇到端口冲突，修改 application-dev.yml 中的 server.port。
前端前端依赖安装慢可尝试使用 yarn 或设置淘宝镜像。
🔍 Troubleshooting
❓ 数据库连接失败
→ 检查 MySQL 服务状态和配置文件中的连接信息。
❓ Redis 连接超时
→ 确保 Redis 已启动，并检查配置中的 host 和 port。
❓ 前端 npm install 报错
→ 清除 node_modules 后重试，或升级 Node.js 版本。
🎯 Next Steps
1
探索完整功能
登录后查看用户管理、角色权限等工作流模块。
2
阅读详细文档
访问项目 README 或启动文档了解更多配置和扩展。
3
尝试代码生成器
使用内置工具快速生成业务代码，加速开发。