RuoYi-Vue-Plus快速开始：环境搭建指南

2026-02-04 04:56:56作者：郦嵘贵Just

还在为搭建企业级多租户管理系统而烦恼吗？本文将手把手带你完成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

📊 系统架构图

graph TB
    A[用户请求] --> B[Nginx负载均衡]
    B --> C[Spring Boot应用]
    C --> D[Sa-Token认证]
    D --> E[业务处理]
    E --> F[MyBatis-Plus ORM]
    F --> G[MySQL数据库]
    C --> H[Redis缓存]
    E --> I[文件存储]
    I --> J[MinIO/OSS]
    C --> K[消息队列]
    K --> L[分布式任务]

🐛 常见问题排查

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>