yudaocode/ruoyi-vue-pro：项目快速开始指南

还在为搭建企业级后台管理系统而烦恼吗？本文将手把手带你快速启动芋道源码的 ruoyi-vue-pro 项目，让你在10分钟内完成从环境准备到系统运行的完整流程！

通过本文，你将获得：

• ✅ 完整的环境准备清单
• ✅ 数据库配置与初始化步骤
• ✅ 后端服务启动方法
• ✅ 前端项目运行指南
• ✅ 常见问题解决方案

📋 环境准备清单

在开始之前，请确保你的开发环境满足以下要求：

系统要求

组件	版本要求	备注
JDK	1.8 或 17+	推荐 JDK 8 或 JDK 17
MySQL	5.7+ 或 8.0+	支持多种数据库
Redis	5.0+	缓存和会话管理
Maven	3.6+	项目构建工具
Node.js	14+	前端构建环境

开发工具推荐

• IDE: IntelliJ IDEA 或 Eclipse
• 数据库工具: Navicat 或 MySQL Workbench
• Redis客户端: Redis Desktop Manager

🗄️ 数据库配置

1. 创建数据库

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

2. 导入SQL脚本

项目提供了完整的数据库初始化脚本：

# 进入项目SQL目录
cd sql/mysql/

# 执行数据库初始化
mysql -uroot -p ruoyi-vue-pro < ruoyi-vue-pro.sql
mysql -uroot -p ruoyi-vue-pro < quartz.sql

3. 数据库表结构概览

erDiagram
    SYSTEM ||--o{ USER : contains
    SYSTEM ||--o{ ROLE : contains
    SYSTEM ||--o{ MENU : contains
    USER ||--o{ ROLE : belongs
    ROLE ||--o{ MENU : has
    INFRA ||--o{ CONFIG : contains
    INFRA ||--o{ JOB : contains
    INFRA ||--o{ FILE : contains
    BPM ||--o{ PROCESS : contains
    BPM ||--o{ TASK : contains

主要功能模块包含：

• 系统管理: 用户、角色、菜单、部门等
• 基础设施: 配置管理、定时任务、文件服务
• 工作流程: 流程设计、任务管理
• 监控统计: 操作日志、系统监控

🔧 后端服务配置与启动

1. 配置文件修改

修改 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
          password: 123456
        slave:
          url: jdbc:mysql://127.0.0.1:3306/ruoyi-vue-pro?useSSL=false&serverTimezone=Asia/Shanghai
          username: root
          password: 123456

  redis:
    host: 127.0.0.1
    port: 6379
    database: 0

2. Maven依赖安装

# 在项目根目录执行
mvn clean install -DskipTests

3. 启动后端服务

# 方式一：使用Maven启动
mvn spring-boot:run -pl yudao-server

# 方式二：在IDE中直接运行
# 找到 yudao-server/src/main/java/cn/iocoder/yudao/YudaoServerApplication.java
# 右键运行 main 方法

4. 验证后端启动

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

• Swagger接口文档: http://localhost:48080/swagger-ui
• Druid监控: http://localhost:48080/druid
• 健康检查: http://localhost:48080/actuator/health

🎨 前端项目配置与启动

项目提供多个前端版本，选择适合的版本进行启动：

Vue3 + Element Plus 版本

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

# 安装依赖
npm install

# 启动开发服务器
npm run dev

配置说明

修改前端配置 src/config/index.ts：

export default {
  // 后端API地址
  baseURL: process.env.NODE_ENV === 'development' ? 'http://localhost:48080' : '/',
  
  // 超时时间
  timeout: 10000,
  
  // 其他配置...
}

启动验证

前端启动后，访问 http://localhost:80 即可看到登录界面。

🔐 首次登录系统

默认账号信息

用户名	密码	权限
admin	admin123	超级管理员
test	test123	测试用户

登录流程

sequenceDiagram
    participant User
    participant Frontend
    participant Backend
    participant Redis
    participant Database

    User->>Frontend: 输入用户名密码
    Frontend->>Backend: 发送登录请求
    Backend->>Database: 验证用户信息
    Backend->>Redis: 存储登录令牌
    Backend-->>Frontend: 返回登录结果
    Frontend-->>User: 跳转到首页

🚀 功能模块体验

成功登录后，你可以体验以下核心功能：

系统管理功能

• 用户管理: 增删改查系统用户
• 角色管理: 配置用户角色权限
• 菜单管理: 动态菜单配置
• 部门管理: 组织架构管理

基础设施

• 代码生成: 快速生成CRUD代码
• 定时任务: 可视化任务调度
• 文件管理: 多存储策略文件服务
• API监控: 接口调用统计

工作流程

• 流程设计: 可视化流程设计器
• 任务审批: 完整的审批流程
• 表单管理: 动态表单配置

⚡ 性能优化建议

数据库优化

-- 为常用查询字段添加索引
CREATE INDEX idx_user_username ON system_user(username);
CREATE INDEX idx_role_status ON system_role(status);
CREATE INDEX idx_menu_parent_id ON system_menu(parent_id);

Redis配置优化

spring:
  redis:
    lettuce:
      pool:
        max-active: 20
        max-wait: 1000
        max-idle: 10
        min-idle: 5

JVM参数优化

# 启动参数示例
java -Xms512m -Xmx1024m -XX:+UseG1GC -jar yudao-server.jar

🔧 常见问题解决

1. 数据库连接失败

问题现象: Communications link failure 解决方案: 检查MySQL服务是否启动，防火墙是否开放3306端口

2. Redis连接失败

问题现象: Connection refused 解决方案: 启动Redis服务：redis-server

3. 端口冲突

问题现象: Port 48080 already in use 解决方案: 修改 application-local.yaml 中的 server.port 配置

4. 前端依赖安装失败

问题现象: npm install 失败 解决方案: 使用淘宝镜像：

npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install

📊 项目结构说明

graph TD
    A[ruoyi-vue-pro] --> B[yudao-framework]
    A --> C[yudao-server]
    A --> D[yudao-module-system]
    A --> E[yudao-module-infra]
    A --> F[yudao-module-bpm]
    A --> G[yudao-module-mall]
    
    B --> B1[通用工具类]
    B --> B2[Starter组件]
    
    C --> C1[主启动类]
    C --> C2[配置文件]
    
    D --> D1[用户管理]
    D --> D2[角色管理]
    D --> D3[菜单管理]

🎯 下一步学习建议

1. 深入了解核心模块: 研究系统管理、工作流等核心模块的实现
2. 定制化开发: 基于代码生成器快速开发业务模块
3. 性能监控: 集成SkyWalking等APM工具进行性能监控
4. 容器化部署: 学习Docker容器化部署方案
5. 微服务改造: 了解yudao-cloud微服务版本

💡 开发技巧

使用代码生成器

1. 在基础设施 -> 代码生成中配置数据源
2. 选择需要生成的表
3. 配置生成参数并生成代码
4. 将生成的代码集成到项目中

自定义业务模块

// 1. 创建Module模块
// 2. 在pom.xml中添加依赖
// 3. 配置数据源和MyBatis
// 4. 实现Controller、Service、Mapper
// 5. 配置菜单和权限

通过本快速开始指南，你应该已经成功搭建并运行了ruoyi-vue-pro项目。这个项目为企业级应用开发提供了完整的解决方案，涵盖了权限管理、工作流程、监控统计等核心功能。

记得在实际项目开发中，根据业务需求进行适当的定制和优化。祝你编码愉快！

提示: 如果在使用过程中遇到问题，可以查看项目日志文件获取详细错误信息，日志路径通常为 ~/logs/yudao-server.log。