学习笔记若依微服务 源码分析

官方文档

资源 链接
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-cloud
Spring Cloud Alibaba 2025.1.0.0 https://sca.aliyun.com
Spring Cloud Gateway — https://spring.io/projects/spring-cloud-gateway
Nacos — https://nacos.io
Sentinel — https://sentinelguard.io
MyBatis 3.x https://mybatis.org
Quartz — http://www.quartz-scheduler.org
Minio — https://min.io
Velocity 2.3 https://velocity.apache.org
SpringDoc 3.0.3 https://springdoc.org
JJWT 0.9.1 https://github.com/jwtk/jjwt
Druid 1.2.28 https://github.com/alibaba/druid
FastJSON2 2.0.62 https://github.com/alibaba/fastjson2
Seata — https://seata.io

核心源码索引

网关模块（ruoyi-gateway）

文件 职责
AuthFilter.java JWT 鉴权全局过滤器
ValidateCodeFilter.java 验证码校验过滤器
XssFilter.java XSS 防护过滤器
ValidateCodeHandler.java 验证码生成端点

认证模块（ruoyi-auth）

文件 职责
TokenController.java 登录/登出/刷新 Token 接口
SysLoginService.java 登录校验核心逻辑
SysPasswordService.java BCrypt 密码校验

安全模块（ruoyi-common-security）

文件 职责
AuthLogic.java 权限校验核心引擎
AuthUtil.java 权限校验静态门面
TokenService.java Token 创建/验证/刷新/删除
PreAuthorizeAspect.java 注解鉴权 AOP 切面
InnerAuthAspect.java 内部调用认证切面
HeaderInterceptor.java 请求头拦截器（恢复用户上下文）
FeignRequestInterceptor.java Feign 请求头传递拦截器

数据权限模块（ruoyi-common-datascope）

文件 职责
DataScope.java 数据权限注解
DataScopeAspect.java 数据权限 SQL 拼接切面

操作日志模块（ruoyi-common-log）

文件 职责
Log.java 操作日志注解
LogAspect.java 操作日志 AOP 切面
AsyncLogService.java 异步日志写入服务

系统管理模块（ruoyi-system）

文件 职责
SysUserServiceImpl.java 用户管理业务逻辑
SysMenuServiceImpl.java 菜单管理与路由构建
SysPermissionServiceImpl.java 权限加载服务

公共工具模块（ruoyi-common-core）

文件 职责
JwtUtils.java JWT 签发与解析
RedisService.java Redis 缓存操作封装
SecurityContextHolder.java ThreadLocal 用户上下文
R.java 统一响应体
BaseEntity.java 实体基类（含 params 用于数据权限注入）

业务支撑模块

文件 职责
GenTableServiceImpl.java 代码生成器核心服务
AbstractQuartzJob.java 定时任务模板方法基类
MinioSysFileServiceImpl.java Minio 文件存储实现

学习文档导航

章节 文件 内容
概览 总览 项目简介、核心概念、典型场景、架构图
架构 微服务架构 微服务架构、模块划分、服务通信
认证 认证授权 JWT+Redis 双令牌、AOP 鉴权、登录流程
网关 网关模块 Gateway 过滤器链、鉴权、验证码
系统管理 系统管理模块 用户/角色/菜单、数据权限、路由构建
公共模块 公共模块 核心工具、Redis 缓存、操作日志
业务支撑 业务支撑模块 代码生成、定时任务、文件管理

数据库表结构

核心业务表关系：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
sys_user         — 用户表
sys_role         — 角色表
sys_menu         — 菜单权限表
sys_dept         — 部门表
sys_post         — 岗位表
sys_config       — 参数配置表
sys_dict_type    — 字典类型表
sys_dict_data    — 字典数据表
sys_notice       — 通知公告表
sys_oper_log     — 操作日志表
sys_logininfor   — 登录日志表
sys_user_role    — 用户-角色关联表
sys_user_post    — 用户-岗位关联表
sys_role_menu    — 角色-菜单关联表
sys_role_dept    — 角色-部门关联表（数据权限）
gen_table        — 代码生成表配置
gen_table_column — 代码生成列配置
sys_job          — 定时任务表
sys_job_log      — 定时任务日志表

SQL 文件位置：sql/