🔥 官方推荐 🔥 RuoYi-Vue 全新 Pro 版本,优化重构所有功能。基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 微信小程序,支持 RBAC 动态权限、数据权限、SaaS 多租户、Flowable 工作流、三方登录、支付、短信、商城、CRM、ERP、AI 大模型等功能。你的 ⭐️ Star ⭐️,是作者持续创作的动力!
📊 项目信息
- 语言
- Java
- Stars
- ⭐ 37,570
- Forks
- 8,148
- 今日新增
- +48
- 排名
- #6
- 收录
- 语言榜
- 趋势日期
- 2026年6月2日
- 最后推送
- 2026/6/1
🏷️ 标签
flowablemybatis-plusmysqlredisredissonspring-securityspringbootvue
5分钟快速开始 RuoYi-Vue-Pro
基于 Spring Boot 和 Vue 的全功能后台管理系统,快速部署并体验核心功能。
🖥️ 操作系统
macOSWindowsLinux
⚙️ 运行环境
JDK8 或 17/21
Node.js16+
MySQL5.7+
Redis5.0+
🔧 工具
Git— 克隆项目代码
Maven— 构建 Java 后端
npm 或 yarn— 构建 Vue 前端
📝 操作步骤
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✓预期输出:SQL 导入成功,无错误信息。
💡确保 MySQL 服务已启动,数据库名默认为 ruoyi-vue-pro。
2
配置后端环境
修改配置文件以连接 MySQL 和 Redis。
如果不在项目根目录,先进入
$ cd ruoyi-vue-pro编辑开发环境配置,或使用其他编辑器
$ nano ruoyi-module-system/src/main/resources/application-dev.yml✓预期输出:文件打开后,找到并修改数据库和 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✓预期输出:看到 'Started Application in ... seconds' 表示启动成功。
💡默认端口为 8080,确保端口未被占用。
4
启动前端管理后台
构建并运行 Vue 前端(以 Vue3 + element-plus 为例)。
进入前端项目目录
$ cd yudao-ui-admin-vue3安装依赖
$ npm install启动开发服务器
$ npm run dev✓预期输出:服务器启动,输出本地访问地址如 http://localhost:80。
💡如果使用其他前端版本,替换目录名和命令。
✅ 验证成功运行
访问前端界面并登录系统。
- ✓后端控制台无错误日志
- ✓前端页面正常加载
- ✓使用默认账号 admin/admin123 登录成功
⚡ 快速提示
版本选择使用 JDK 8 选择 master 分支,JDK 17/21 选择 master-jdk17 分支。
配置如果遇到端口冲突,修改 application-dev.yml 中的 server.port。
前端前端依赖安装慢可尝试使用 yarn 或设置淘宝镜像。
🔍 常见问题排查
❓ 数据库连接失败
→ 检查 MySQL 服务状态和配置文件中的连接信息。
❓ Redis 连接超时
→ 确保 Redis 已启动,并检查配置中的 host 和 port。
❓ 前端 npm install 报错
→ 清除 node_modules 后重试,或升级 Node.js 版本。
🎯 下一步
1
探索完整功能
登录后查看用户管理、角色权限等工作流模块。
2
阅读详细文档
访问项目 README 或启动文档了解更多配置和扩展。
3
尝试代码生成器
使用内置工具快速生成业务代码,加速开发。












