若依（RuoYi）是一款基于Spring Boot的权限管理系统，其代码结构清晰、模块化程度高，适合学习企业级项目开发。以下是对若依管理台后端工程的核心模块和代码结构的讲解：
一、项目结构概览 ruoyi-admin // 启动模块（主工程） ruoyi-common // 公共模块（工具类、通用组件） ruoyi-system // 系统模块（核心业务：用户、角色、菜单等） ruoyi-framework // 框架模块（核心配置、权限控制） ruoyi-generator // 代码生成模块 二、核心技术栈核心框架：Spring Boot + MyBatis + Spring Security
权限控制：基于角色的访问控制（RBAC）、接口级权限注解
数据库：MySQL + Redis（缓存、会话管理）
工具类：Hutool工具库、Jackson序列化
其他：Swagger（API文档）、Quartz（定时任务）
三、核心模块详解 1. 权限控制（Spring Security）认证流程：
用户登录 → LoginService.login() → 生成Token（JWT或Redis Session）
请求拦截 → JwtAuthenticationTokenFilter → 验证Token并注入用户信息
权限注解：@PreAuthorize("@ss.hasPermi('system:user:list')") // 接口权限校验 public R list(...) { ... }
权限校验逻辑：
PermissionService 根据用户角色动态加载权限数据
权限数据缓存到Redis，避免频繁查询数据库
2. 系统管理模块（ruoyi-system）核心实体：
SysUser（用户）、SysRole（角色）、SysMenu（菜单）
数据库表关系：
用户 ↔ 角色（多对多，sys_user_role表）
角色 ↔ 菜单（多对多，sys_role_menu表）
关键代码：
SysUserController：用户管理接口（增删改查）
SysRoleService：角色权限分配逻辑
SysMenuServiceImpl.buildMenuTree()：递归构建菜单树
3. 代码生成器（ruoyi-generator）作用：通过数据库表自动生成Controller、Service、Mapper代码
核心类：
GenTable：表信息模型
VelocityInitializer：模板引擎生成代码
配置文件：
generator.yml：配置包路径、作者信息等
4. 通用工具类（ruoyi-common）常用工具：
SecurityUtils：获取当前登录用户
ServletUtils：处理HTTP请求响应
StringUtils：字符串处理
ExcelUtil：POI封装导出Excel
四、核心配置解析全局配置：application.yml（数据源、Redis、Swagger开关）
安全配置：SecurityConfig（放行路径、密码加密方式）
MyBatis配置：MyBatisConfig（分页插件、事务管理）
跨域配置：CorsConfig（全局跨域处理）
五、代码特点分层清晰：Controller → Service → Mapper
注解驱动：@DataScope（数据权限过滤）、@Log（操作日志）
动态SQL：使用MyBatis动态标签（如<if>、<foreach>）
缓存优化：高频数据（如菜单、字典）缓存到Redis
异常处理：全局异常处理器GlobalExceptionHandler
六、学习建议从登录流程切入：跟踪LoginController → AuthenticationManager → UserDetailsService
调试权限注解：修改@PreAuthorize观察接口拦截效果
扩展新模块：通过代码生成器创建新表，生成CRUD代码
定制数据权限：参考@DataScope实现部门数据过滤
学习前端交互：结合若依前端代码（Vue）理解接口调用
示例：用户登录流程
// 登录入口 @PostMapping("/login") public R login(@RequestBody LoginBody loginBody) { String token = loginService.login(loginBody.getUsername(), loginBody.getPassword()); return R.ok().put("token", token); } // 实际认证逻辑（LoginService） public String login(String username, String password) { // 1. 用户验证 Authentication authentication = authenticationManager.authenticate(...); // 2. 生成Token return tokenService.createToken(loginUser); }
