芋道源码 ruoyi-vue-pro 企业级系统快速部署与应用指南

环境准备：打造你的开发工具箱

学习目标：完成开发环境搭建，了解项目技术栈构成，为后续部署做好准备
⏱️ 预计15分钟 | [■■□□□] 20%

在开始部署前，请确保你的开发环境已安装以下核心组件：

核心技术栈选择

• JDK：推荐安装JDK 17（原因：长期支持版本，性能优化更优，对新特性支持更完善）
• 数据库：MySQL 8.0（支持多种数据库，但MySQL社区活跃，文档丰富）
• 缓存系统：Redis 6.0+（用于会话管理和数据缓存，提升系统响应速度）
• 构建工具：Maven 3.8+（项目依赖管理和构建）
• 前端环境：Node.js 16+（Vue3前端项目构建需要）

⚠️ 小贴士：如果你的开发环境已有JDK 8，也可以直接使用，但建议新项目优先选择JDK 17以获得更好的性能和安全性。

开发工具推荐

• IDE：IntelliJ IDEA（推荐商业版，社区版功能有限）
• 数据库工具：Navicat或DBeaver（可视化数据库管理）
• 版本控制：Git（项目版本管理）

项目部署：从源码到运行的完整流程

学习目标：掌握项目拉取、数据库配置和后端服务启动的关键步骤
⏱️ 预计25分钟 | [■■■■□] 80%

1. 获取项目源码

📋 复制以下命令克隆项目代码库：

git clone https://gitcode.com/yudaocode/ruoyi-vue-pro
cd ruoyi-vue-pro

2. 数据库初始化

创建数据库

📋 复制以下SQL命令在MySQL中执行：

CREATE DATABASE `ruoyi-vue-pro` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

导入初始化脚本

📋 复制以下命令执行SQL文件：

# 进入SQL脚本目录
cd sql/mysql/

# 导入主数据库脚本
mysql -uroot -p ruoyi-vue-pro < ruoyi-vue-pro.sql

# 导入定时任务脚本
mysql -uroot -p ruoyi-vue-pro < quartz.sql

💡 小贴士：执行命令时会提示输入MySQL密码，确保你的MySQL服务已启动并允许root用户本地登录。

3. 后端配置与启动

修改配置文件

编辑 yudao-server/src/main/resources/application-local.yaml 文件，更新数据库连接信息：

📋 关键配置示例：

spring:
  datasource:
    dynamic:
      datasource:
        master:
          url: jdbc:mysql://127.0.0.1:3306/ruoyi-vue-pro?useSSL=false&serverTimezone=Asia/Shanghai
          username: root  # 替换为你的MySQL用户名
          password: 123456  # 替换为你的MySQL密码
  redis:
    host: 127.0.0.1  # Redis服务器地址
    port: 6379       # Redis端口

构建并启动后端服务

📋 复制以下命令构建项目：

# 返回项目根目录
cd ../../..

# 构建项目
mvn clean install -DskipTests

# 启动后端服务
mvn spring-boot:run -pl yudao-server

⏳ 等待提示：服务启动成功会显示 "Started YudaoServerApplication" 信息，通常需要1-3分钟。

4. 前端项目启动

安装依赖并启动

📋 复制以下命令启动Vue3前端：

# 进入Vue3前端目录
cd yudao-ui/yudao-ui-admin-vue3

# 安装依赖
npm install

# 启动开发服务器
npm run dev

功能验证：系统访问与核心功能体验

学习目标：成功登录系统，验证核心功能模块，了解系统基本操作
⏱️ 预计10分钟 | [■■■■■] 100%

访问系统

后端服务启动后，访问以下地址验证服务状态：

• API文档：http://localhost:48080/swagger-ui.html（验证后端接口）
• 前端页面：http://localhost:80（访问系统登录页）

首次登录

使用默认账号登录系统：

• 用户名：admin
• 密码：admin123

登录成功后，你将看到系统控制台，包含系统管理、基础设施、工作流程等核心模块。

核心功能体验

系统架构概览

系统采用分层架构设计，主要包含前端服务、接入服务、后端服务和存储服务四个部分：

• 前端层：提供Vue管理后台和UniApp移动端应用
• 接入层：通过Nginx实现负载均衡
• 应用层：基于Spring Boot的微服务架构
• 数据层：包含关系型数据库、缓存、文件存储等

业务模块构成

系统业务架构采用模块化设计，主要包含：

• 基础模块：系统功能、基础设施、工作流程
• 业务模块：支付系统、会员中心、数据报表
• 应用系统：电商商城、办公自动化、客户关系管理

关键功能演示

代码生成功能：通过可视化配置快速生成CRUD代码，大幅提升开发效率。

定时任务管理：可视化配置和管理系统定时任务，支持任务状态监控和手动执行。

进阶应用：系统调优与功能扩展

学习目标：掌握系统性能优化方法，了解常见问题解决思路，探索功能扩展方向

系统调优指南

数据库优化

为常用查询字段添加索引提升查询性能： 📋 复制以下SQL命令：

-- 用户表用户名索引
CREATE INDEX idx_user_username ON system_user(username);
-- 角色表状态索引
CREATE INDEX idx_role_status ON system_role(status);

Redis配置优化

修改Redis连接池配置提高缓存性能：

spring:
  redis:
    lettuce:
      pool:
        max-active: 20  # 最大连接数
        max-idle: 10    # 最大空闲连接
        min-idle: 5     # 最小空闲连接

故障排除流程

遇到问题时，建议按以下流程排查：

1. 检查服务状态：确认MySQL、Redis等依赖服务是否正常运行
2. 查看日志文件：日志路径通常为 ~/logs/yudao-server.log
3. 检查配置文件：重点检查数据库连接和端口配置
4. 验证网络环境：确认端口未被占用，防火墙未阻止连接

常见问题解决：

• 数据库连接失败：检查MySQL服务状态和连接参数
• 端口冲突：修改 application-local.yaml 中的 server.port 配置
• 前端依赖安装失败：使用淘宝镜像 npm install --registry=https://registry.npmmirror.com

进阶挑战任务

1. 自定义业务模块开发：基于代码生成器创建一个新的业务模块
2. 多数据源配置：尝试配置主从分离的数据库架构
3. 容器化部署：使用项目中的Docker配置实现容器化部署

通过本指南，你已经掌握了ruoyi-vue-pro项目的部署和基础使用方法。这个企业级开发平台提供了丰富的功能组件和灵活的扩展机制，可以帮助你快速构建各类业务系统。随着对系统的深入了解，你可以逐步探索其高级特性，如工作流引擎、多租户支持和微服务架构等。