ruoyi-vue-pro 深入学习：MyBatis 数据层与数据权限
2026-08-25 3.2k 字 13 分钟

ruoyi-vue-pro 深入学习：MyBatis 数据层与数据权限

第五章 · MyBatis 数据层与数据权限（mybatis Starter） 这一章回答数据访问的三个核心问题：每个表的公共字段谁负责填充（BaseDO）、为什么一个 Mapper 不用写任何 SQL 就能 CRUD + 分页（BaseMapperX）、**如何做到”不同角色看到不同部门的数据”**（数据权限插件）。读完你会发现：业务代码写数据时几乎零样板，全靠这一层”拦截 + 填充 + 拼接”的魔法。 1. 模块概述yudao-spring-boot-starter-mybatis 是基于 MyBatis-Plus 的增强 Starter（24 个文件），它解决业务开发中的”最后一公里
ruoyi-vue-pro 深入学习：安全与鉴权
2026-08-25 3.3k 字 13 分钟

ruoyi-vue-pro 深入学习：安全与鉴权

第四章 · 安全与鉴权（security Starter） 这一章是全工程鉴权架构的心脏。它回答三个问题：Token 从哪来、谁校验它、权限怎么判。读完你会明白：为什么请求能带上 LoginUser，为什么 @PreAuthorize("@ss.hasPermission('system:user:query')") 能拦人，以及 framework 如何”不依赖 system 却拿到权限”。 1. 模块概述yudao-spring-boot-starter-security 在 Spring Security 之上做了一层”面向多用户类型、基于 Tok
ruoyi-vue-pro 深入学习：Web 请求层
2026-08-25 2.3k 字 9 分钟

ruoyi-vue-pro 深入学习：Web 请求层

第三章 · Web 请求层（web Starter） 上一章的 CommonResult 定义了”返回长什么样”，这一章回答”请求进来、结果出去，中间经历了什么“。核心是三个机制：统一 API 前缀（为什么你的 Controller 天然带 /admin-api）、全局异常翻译（任何异常都被打成 CommonResult）、以及 请求上下文贯通（用户、结果如何被塞进 request 供后续 Filter 读取）。 1. 模块概述yudao-spring-boot-starter-web 是 web 层的”宿主” Starter（62 个文件），它并不只是 URL 路由，而是承载了一组横切能
ruoyi-vue-pro 深入学习：错误码体系与统一返回
2026-08-25 2.7k 字 10 分钟

ruoyi-vue-pro 深入学习：错误码体系与统一返回

第二章 · 错误码体系与统一返回（yudao-common 基础层） 这一章是整个平台的地基。无论你写哪个业务模块，最终返回的 JSON 一定是 CommonResult，抛出的业务异常一定是 ServiceException。理解了这里的”三条主线”——错误码定义、异常体系、统一返回——你就拿到了读懂全工程的第一把钥匙。 1. 模块概述yudao-framework/yudao-common 是零 Spring 依赖的纯基础模块（56 个 Java 文件），它提供： 错误码体系：ErrorCode + GlobalErrorCodeConstants + ServiceErrorCod
ruoyi-vue-pro 深入学习：Maven 多模块工程与依赖治理
2026-08-25 2.7k 字 10 分钟

ruoyi-vue-pro 深入学习：Maven 多模块工程与依赖治理

第一章 · Maven 多模块工程结构与依赖治理 本章解剖工程的”骨架”：一个 Spring Boot 应用是怎么被拆成多个 Maven 工程，又如何被重新拼装成一个可启动的应用。这是读懂后续所有章节的前提——因为每个 Starter、每个业务模块的”存在方式”都由这套结构决定。 1. 模块概述RuoYi-Vue-Pro 单仓库即是一个完整的 Maven parent POM。它没有把所有代码堆进一个工程，而是按”通用基础层 / 组装层 / 业务模块层“三个层级拆成了几十个 Maven 模块。根 pom.xml（源码根/pom.xml）用 <modules>
若依微服务 深入学习：参考资料索引
2026-06-22 860 字 3 分钟

若依微服务 深入学习：参考资料索引

官方文档 资源 链接 RuoYi-Cloud 官方仓库 https://github.com/yangzongzhuan/RuoYi-Cloud 若依官网 http://www.ruoyi.vip RuoYi-Cloud 官方文档 https://doc.ruoyi.vip/ruoyi-cloud/ 技术栈参考 技术 版本 官方文档 Spring Boot 4.0.6 https://spring.io/projects/spring-boot Spring Cloud 2025.1.1 https://spring.io/projects/spring-c
若依微服务 深入学习：业务支撑模块
2026-06-22 4.6k 字 18 分钟

若依微服务 深入学习：业务支撑模块

1. 模块概述本章分析三个业务支撑模块：代码生成器（ruoyi-gen）、定时任务（ruoyi-job）和文件管理（ruoyi-file）。它们是平台开发的”加速器”——帮你快速生成 CRUD 代码、管理定时任务、统一文件上传。 模块关系graph LR subgraph 业务支撑 GEN[ruoyi-gen代码生成器] JOB[ruoyi-job定时任务] FILE[ruoyi-file文件管理] end subgraph 基础设施 MYSQL[(MySQL)] MINIO[(Minio
若依微服务 深入学习：公共模块
2026-06-22 4.2k 字 17 分钟

若依微服务 深入学习：公共模块

1. 模块概述ruoyi-common 是若依微服务平台的 基础设施层，包含 9 个子模块，为上层的网关、认证和业务服务提供统一的基础能力。 子模块全景 子模块 职责 核心组件 ruoyi-common-core 核心工具与基础类 JwtUtils, StringUtils, R（统一响应）, BaseEntity ruoyi-common-redis Redis 缓存服务 RedisService, RedisConfig ruoyi-common-security 认证鉴权框架 AuthLogic, TokenService, PreAuthorizeAspect, He
若依微服务 深入学习：系统管理模块
2026-06-22 6.2k 字 26 分钟

若依微服务 深入学习：系统管理模块

1. 模块概述ruoyi-system 是整个平台的 核心业务模块，负责用户、角色、菜单、部门、岗位、字典、配置、通知公告、操作日志、登录日志等全部系统管理功能。 模块分层架构graph TB subgraph Controller层 UC[SysUserController] RC[SysRoleController] MC[SysMenuController] DC[SysDeptController] end subgraph Service层 USI[ISysUserService
若依微服务 深入学习：网关模块
2026-06-22 3.8k 字 15 分钟

若依微服务 深入学习：网关模块

1. 模块概述ruoyi-gateway 是整个微服务系统的 唯一入口，基于 Spring Cloud Gateway 构建。所有客户端请求首先到达网关，经过过滤器链处理后路由到对应的后端服务。 模块职责 职责 实现组件 源码 JWT 鉴权 AuthFilter 全局过滤器 order=-200 验证码校验 ValidateCodeFilter 全局过滤器 order=-100 XSS 防护 XssFilter 全局过滤器 黑名单拦截 BlackListUrlFilter 全局过滤器 Sentinel 熔断 SentinelFallbackHand