若依微服务架构（RuoYi-Cloud）使用指南

若依微服务版（RuoYi-Cloud）是一套基于 Spring Boot、Spring Cloud & Alibaba​ 的分布式微服务架构权限管理系统，采用前后端分离模式（前端基于 Vue/Element UI 或 Vue3）。它内置了用户管理、部门管理、角色权限、代码生成、定时任务等常用业务模块，非常适合作为企业级快速开发平台。

一、环境准备

在搭建项目前，请确保本地已安装以下依赖（以 3.x 版本为例）：

• JDK：1.8（推荐 1.8.0_200+，若使用 Spring Boot 3 则需 JDK 17+）

• MySQL：5.7.x / 8.0.x

• Redis：5.0+（默认端口 6379）

• Maven：3.6.0+

• Node.js：14.x / 16.x LTS（前端构建，避免过高版本）

• Nacos：2.0.4+（注册中心与配置中心）

• Sentinel：1.8.6（流量控制，可选）

二、获取源码与初始化数据

1. 拉取源码：

   从 Gitee 克隆项目：https://gitee.com/y_project/RuoYi-Cloud。

2. 初始化数据库：

   • 创建数据库 ry-cloud，导入项目 sql目录下的 ry_xxxx.sql（主业务数据）。

   • 创建数据库 ry-config，导入 ry_config_xxxx.sql（Nacos 配置数据）。

   • （可选）创建 ry-seata库并导入脚本，用于分布式事务 。

三、中间件配置（Nacos & Redis）

1. 启动 Redis：确保 Redis 服务正常启动运行 。

2. 配置并启动 Nacos：

   • 下载并解压 Nacos，单机模式启动（Windows 执行 startup.cmd -m standalone）。

   • 访问 http://localhost:8848/nacos（默认账号/密码：nacos/nacos）。

   • 进入 配置管理 -> 配置列表，逐一修改各服务的配置文件（如 ruoyi-system-dev.yml、ruoyi-gateway-dev.yml等），将其中 MySQL 和 Redis 的连接地址、账号、密码​ 修改为本地环境对应的信息，然后点击“发布” 。

四、后端服务启动

在 IDEA 中导入后端项目，依次启动以下核心模块（需在 Nacos 启动之后）：

• ruoyi-gateway（网关模块，端口 8080，必须）

• ruoyi-auth（认证授权中心，端口 9200，必须）

• ruoyi-modules-system（系统模块，端口 9201，必须）

• （可选）ruoyi-gen（代码生成）、ruoyi-job（定时任务）、ruoyi-file（文件服务）、ruoyi-visual-monitor（监控中心）

五、前端项目启动

1. 进入前端目录 ruoyi-ui。

2. 安装依赖（建议指定淘宝镜像加速）：

   npm install --registry=https://registry.npm.taobao.org

   注意：不建议直接使用 cnpm，可能会有依赖包兼容问题 。

3. 启动前端服务：

   npm run dev

4. 访问 http://localhost:80即可进入登录页，默认管理员账号：admin，密码：admin123。

六、核心模块结构说明

com.ruoyi
├── ruoyi-ui            // 前端框架
├── ruoyi-gateway       // 网关模块（路由、限流、跨域）
├── ruoyi-auth          // 认证中心（OAuth2 + Redis）
├── ruoyi-api           // 服务调用 Feign 接口层
├── ruoyi-common        // 通用工具包（核心、多数据源、日志、安全等）
├── ruoyi-modules       // 业务微服务模块
│   ├── ruoyi-system    // 系统管理（用户、角色、菜单、部门等）
│   ├── ruoyi-gen       // 代码生成
│   ├── ruoyi-job       // 定时任务
│   └── ruoyi-file      // 文件服务
└── ruoyi-visual        // 监控中心（Spring Boot Admin）

七、常见注意事项

• 版本严格匹配：若依微服务对 JDK、Nacos、Sentinel 等组件版本要求较高，版本不匹配极易导致启动失败或连接异常 。

• Nacos 配置生效：如果发现数据库连接或 Redis 报错，优先检查 Nacos 中对应 .yml配置是否已正确修改并发布 。

• 服务注册检查：所有后端服务启动后，可在 Nacos 控制台的“服务列表”中看到已注册的服务实例 。

如需更深入的功能操作（如代码生成使用、新模块开发、服务间接口调用等），可以参考若依官方文档：https://doc.ruoyi.vip/ruoyi-cloud/。