【RuoYi-Cloud-Plus】学习笔记DAY-01

【RuoYi-Cloud-Plus】学习笔记

1. 前言

在微服务架构选型中，RuoYi-Cloud 无疑是国内最流行的脚手架之一。但随着技术迭代，原版在某些技术栈上显得略显保守（如 Spring Security 的复杂性、Feign 的性能瓶颈等）。

RuoYi-Cloud-Plus（以下简称 Plus 版）应运而生。它不是简单的修补，而是基于 Spring Boot 3.x 和 JDK 17 的全方位重写。本文将带你快速上手这个“更强、更现代”的微服务框架。

官方文档：https://plus-doc.dromara.org/#/ruoyi-cloud-plus/home
开源地址：Gitee | GitHub

2. 核心特性：Plus 版强在哪里？

根据官方对比，Plus 版在架构设计上做出了巨大的革新，以下是几个最核心的差异点：

功能模块	RuoYi-Cloud (原版)	RuoYi-Cloud-Plus (本框架)	核心优势
核心依赖	Spring Boot 2.x / JDK 8	Spring Boot 3.4+ / JDK 17+	拥抱新特性，性能更优
鉴权框架	Spring Security (配置繁琐)	Sa-Token (简单、功能全)	代码量减少 80%，支持踢人、临时身份
RPC 调用	OpenFeign	Apache Dubbo 3.x	性能更强，支持多种协议
ORM 框架	MyBatis (XML 手写 SQL)	MyBatis-Plus	极大简化 CRUD，插件丰富
任务调度	Quartz (基于 DB 锁)	SnailJob (分布式、分片)	天生支持分布式，高性能
Redis 客户端	Lettuce + RedisTemplate	Redisson	基于 Netty，支持分布式锁/布隆过滤器
前端技术	Vue2 / Vue3 JS	Vue3 + TS + ElementPlus	类型安全，开发体验更好

3. 环境准备

Plus 版对环境要求较高，启动前请务必检查：

• JDK: 17 或 21 (强制要求，不再支持 JDK 8)
• MySQL: 8.0+ (推荐，支持多数据源异构切换)
• Redis: 5.0+ (建议 7.x)
• Nacos: 2.x (配置中心与注册中心)
• Maven: 3.8+

4. 快速启动指南

4.1 拉取代码

git clone https://gitee.com/dromara/RuoYi-Cloud-Plus.git

4.2 初始化数据库

1. 创建数据库 ry-cloud。
2. 执行 sql 目录下的脚本。注意：Plus 版支持多租户，SQL 脚本中包含租户相关的表结构。

4.3 Nacos 配置 (关键步骤)

Plus 版将 Nacos 源码集成以便调试，但生产环境通常使用独立 Nacos。

1. 修改 ruoyi-common/ruoyi-common-nacos 下的 bootstrap.yml，指向你的 Nacos 地址。
2. 导入配置：将项目 config 目录下的所有配置文件导入到 Nacos 配置中心。

注意区分 dev、prod 环境。
检查 application-common.yml 中的 Redis、MySQL 地址是否正确。

4.4 启动服务

建议按照以下顺序启动：

1. ruoyi-gateway (网关服务，端口 8080) —— 流量入口。
2. ruoyi-auth (认证中心，端口 9200) —— 颁发 Token。
3. ruoyi-modules-system (系统模块，端口 9201) —— 核心业务。
   启动成功后，访问网关地址（通常是 http://localhost:8080）即可看到 Swagger 文档或前端页面。

5. 常见问题排查

Q: 启动报错 ‘Java heap space’?
A: 微服务模块较多，建议 IDEA 中每个服务分配至少 256M 内存 (-Xms256m -Xmx512m)。

Q: Nacos 连接失败?
A: 微服务模块较多，建议 IDEA 中每个服务分配至少 256M 内存 (-Xms256m -Xmx512m)。