RuoYi-Vue-Plus快速开始：环境搭建指南
项目地址: https://gitcode.com/dromara/RuoYi-Vue-Plus 还在为搭建企业级多租户管理系统而烦恼吗？本文将手把手带你完成RuoYi-Vue-Plus的环境搭建，让你在30分钟内快速启动这个功能强大的后台管理系统！
🎯 你将获得
- ✅ 完整的开发环境配置步骤
- ✅ 数据库初始化与配置详解
- ✅ Redis缓存服务搭建指南
- ✅ 项目启动与验证方法
- ✅ 常见问题排查解决方案
📋 环境要求
在开始之前，请确保你的系统满足以下最低要求：
| 组件 | 版本要求 | 推荐版本 | 备注 |
|---|---|---|---|
| JDK | ≥ 17 | JDK 17/21 | 必须使用JDK 17或更高版本 |
| MySQL | ≥ 5.7 | MySQL 8.0 | 支持多种数据库 |
| Redis | ≥ 5.0 | Redis 7.0 | 用于缓存和分布式锁 |
| Maven | ≥ 3.6 | Maven 3.8+ | 项目构建工具 |
| Node.js | ≥ 16 | Node.js 18+ | 前端项目需要 |
🚀 快速开始四步曲
第一步：环境准备
1.1 JDK安装与配置
# 检查Java版本
java -version
# 如果未安装JDK 17，请下载并安装
# 设置JAVA_HOME环境变量
export JAVA_HOME=/path/to/jdk-17
export PATH=$JAVA_HOME/bin:$PATH
1.2 数据库准备
创建MySQL数据库并设置字符集：
CREATE DATABASE `ry-vue` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
1.3 Redis安装
# 使用Docker快速启动Redis
docker run -d --name redis \
-p 6379:6379 \
-v redis_data:/data \
redis:7-alpine \
--requirepass "ruoyi123"
# 或者使用系统包管理器安装
# Ubuntu/Debian
sudo apt install redis-server
第二步：项目初始化
2.1 克隆项目
git clone https://gitcode.com/dromara/RuoYi-Vue-Plus.git
cd RuoYi-Vue-Plus
2.2 导入数据库
执行SQL脚本初始化数据库结构：
# 导入主数据库结构
mysql -uroot -p ry-vue < script/sql/ry_vue_5.X.sql
# 导入工作流相关表（可选）
mysql -uroot -p ry-vue < script/sql/ry_workflow.sql
# 导入定时任务表（可选）
mysql -uroot -p ry-vue < script/sql/ry_job.sql
2.3 配置文件修改
编辑开发环境配置文件 ruoyi-admin/src/main/resources/application-dev.yml：
spring:
datasource:
dynamic:
datasource:
master:
url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8
username: root
password: your_password # 修改为你的数据库密码
spring.data:
redis:
host: localhost
port: 6379
password: ruoyi123 # 与Redis配置的密码保持一致
第三步：项目启动
3.1 使用Maven编译项目
# 清理并编译项目
mvn clean compile -DskipTests
# 或者直接运行开发环境
mvn spring-boot:run -Pdev
3.2 使用IDE启动（推荐）
在IntelliJ IDEA或Eclipse中：
- 导入Maven项目
- 选择
ruoyi-admin模块 - 运行
DromaraApplication.java - 使用
dev环境配置文件
3.3 Docker Compose一键部署
项目提供了完整的Docker部署方案：
cd script/docker
docker-compose up -d
第四步：验证与访问
4.1 服务健康检查
项目启动后，访问以下端点验证服务状态：
# 健康检查
curl http://localhost:8080/actuator/health
# 接口文档
# 访问 http://localhost:8080/doc.html
4.2 登录系统
默认管理员账号：
- 用户名：admin
- 密码：admin123
访问地址：http://localhost:8080
🔧 高级配置
多数据源配置
RuoYi-Vue-Plus支持多种数据库同时使用：
spring:
datasource:
dynamic:
datasource:
master:
url: jdbc:mysql://localhost:3306/ry-vue
username: root
password: root
oracle:
url: jdbc:oracle:thin:@//localhost:1521/XE
username: SYSTEM
password: oracle123
postgres:
url: jdbc:postgresql://localhost:5432/postgres
username: postgres
password: postgres123
Redis集群配置
对于生产环境，建议使用Redis集群：
spring.data:
redis:
cluster:
nodes:
- 192.168.1.100:6379
- 192.168.1.101:6379
- 192.168.1.102:6379
password: your_redis_password
邮件服务配置
启用邮件通知功能：
mail:
enabled: true
host: smtp.163.com
port: 465
user: your_email@163.com
pass: your_email_password
sslEnable: true
📊 系统架构图
🐛 常见问题排查
Q1: 端口冲突问题
# 检查端口占用
netstat -tlnp | grep 8080
# 修改应用端口
server:
port: 8081
Q2: 数据库连接失败
检查数据库服务是否启动：
# MySQL状态检查
systemctl status mysql
# 连接测试
mysql -uroot -p -e "SHOW DATABASES;"
Q3: Redis连接异常
# Redis服务检查
redis-cli ping
# 应返回 PONG
# 密码验证
redis-cli -a ruoyi123 ping
Q4: 依赖下载失败
配置国内Maven镜像：
<!-- settings.xml -->
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
🎯 下一步行动
成功启动系统后，建议你：
- 探索系统功能：熟悉用户管理、权限控制、工作流等核心功能
- 阅读官方文档：深入了解各模块的使用方法和最佳实践
- 尝试二次开发：基于业务需求进行定制化开发
- 部署到生产环境：配置生产环境参数和安全策略
📝 总结
通过本指南，你已经成功完成了RuoYi-Vue-Plus的环境搭建。这个强大的多租户管理系统为你提供了：
- 🏢 完善的后台管理功能
- 🔐 强大的权限控制系统
- 📊 丰富的数据可视化能力
- ⚡ 高性能的分布式架构
- 🔧 灵活的扩展机制
现在，你可以开始探索这个系统的更多功能，或者基于它进行二次开发来满足你的业务需求了！
💡 提示：如果在搭建过程中遇到任何问题，可以查看项目的日志文件
logs/application.log来获取详细的错误信息。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
