基于若依（RuoYi）框架的二次开发学习指南

基于若依RuoYi框架的二次开发学习指南从入门到实战若依RuoYi是目前国内非常流行的 Java 企业级快速开发框架。很多开发者在公司项目中会遇到基于若依进行二次开发的需求。本文将带你全面了解若依的技术栈、二次开发的核心模块并提供学习路线与实战流程图助你快速上手。一、若依框架简介若依RuoYi是一款基于 Spring Boot、Spring Security、MyBatis 和 Thymeleaf或 Vue的企业级快速开发平台提供了代码生成器、权限管理、系统监控、日志管理等现成功能大大减少了重复造轮子的工作。目前主要分为两个版本RuoYi经典版前端使用 Thymeleaf Bootstrap jQuery适合后端开发者快速构建管理后台。RuoYi-Vue前后端分离前端使用 Vue Element UI后端提供 RESTful API。本文重点讨论RuoYi-Vue的二次开发这是目前企业中最常用的版本。二、若依的技术栈概览层次技术选型说明后端框架Spring Boot 2.x微服务风格方便集成安全框架Spring Security JWT基于 token 的权限认证持久层MyBatis Plus / MyBatis简化 CRUD支持多数据源数据库MySQL支持 Oracle、SQL Server动态切换缓存Redis用于 token 存储、数据缓存工具库Hutool、Fastjson、EasyExcel 等提升开发效率前端Vue版Vue 2 / 3 Element UI Vuex Vue Router单页应用代码生成自定义代码生成器一键生成前后端 CRUD 代码三、二次开发的典型场景及学习重点二次开发通常指在若依已有功能基础上新增业务模块或改造现有模块。主要涉及以下几个方面新建业务表 代码生成器使用自定义接口开发Controller、Service、Mapper权限控制基于 PreAuthorize 注解多数据源配置与切换前端页面改造与菜单配置工作流集成若依自带简易工作流或扩展 Flowable下面逐一展开。四、二次开发实战流程附流程图4.1 总体流程需求分析设计数据库表使用若依代码生成器生成前后端代码配置菜单与权限调整业务逻辑测试与部署4.2 代码生成器使用详解若依的代码生成器是其核心亮点可以基于数据库表自动生成后端Controller、Service、Mapper、Entity、XML 文件前端Vue 页面列表、新增、编辑、查询、API 接口定义操作步骤在数据库创建业务表遵循若依规范主键为id建议包含create_by,create_time,update_by,update_time,del_flag等字段。登录若依管理后台 → 系统工具 → 代码生成 → 导入表。编辑生成配置树表、主子表、显示字段、查询条件等。点击“生成代码”并下载压缩包。将生成的前端代码放入src/views后端代码放入对应包中。运行 SQL 脚本菜单 SQL自动生成菜单权限。创建业务表后台导入表配置生成规则生成代码 zip解压覆盖执行菜单 SQL刷新页面新模块可直接使用4.3 自定义接口开发示例假设我们需要新增一个“积分兑换记录”模块除了代码生成的基础 CRUD还需额外实现一个统计接口。步骤Mapper 接口在对应的Mapper.java中添加自定义方法。Mapper.xml编写 SQL。Service 接口与实现声明方法并实现。Controller暴露 REST 接口并添加权限注解。RestControllerRequestMapping(/point/record)publicclassPointRecordController{AutowiredprivateIPointRecordServicepointRecordService;PreAuthorize(ss.hasPermi(point:record:stat))GetMapping(/stat)publicAjaxResultstat(){returnAjaxResult.success(pointRecordService.getStatData());}}4.4 权限控制Spring Security JWT若依的权限基于 Spring Security但通过自定义PreAuthorize注解和ss.hasPermi表达式简化了使用。菜单权限后台配置菜单分配角色。按钮级权限前端通过v-hasPermi指令控制显示/隐藏。el-button v-hasPermi[point:record:add] typeprimary新增/el-buttonPreAuthorize(ss.hasPermi(point:record:add))PostMappingpublicAjaxResultadd(RequestBodyPointRecordrecord){...}4.5 多数据源配置若依支持动态数据源切换常用于读写分离或连接不同业务库。配置步骤在application-druid.yml中定义多个数据源。在需要使用非主数据源的 Service 方法上添加DataSource注解。ServicepublicclassOrderService{DataSource(valueDataSourceType.SLAVE)publicListOrderlistOrders(){// 从从库查询}}五、学习路线与资源推荐5.1 循序渐进学习路线图掌握 Spring Boot / MyBatis 基础下载并运行 RuoYi-Vue熟悉项目结构与配置文件学习代码生成器并生成一个简单模块深入 Spring Security JWT 认证流程尝试多数据源 缓存 日志集成阅读源码: 数据权限、操作日志、定时任务独立完成一个复杂业务模块二次开发5.2 官方资源若依官网http://ruoyi.vipRuoYi-Vue GitHubhttps://gitee.com/y_project/RuoYi-Vue文档包含部署、开发手册、常见问题5.3 二次开发常见问题与解决问题解决方案代码生成后访问菜单空白检查生成的 Vue 文件路由是否正确以及后端 Controller 的RequestMapping是否匹配权限不足 403检查角色是否分配了对应权限PreAuthorize表达式是否正确多数据源事务失效默认数据源为主库如需跨库事务需手动编程式事务或使用分布式事务方案前端请求报跨域若依后端已配置跨域检查 Nginx 或网关配置确保前端代理正确六、总结若依是一个低门槛、高产出的快速开发框架非常适合企业级后台管理系统的二次开发。通过学习若依你可以掌握 Spring Boot Vue 的实际项目整合理解代码生成的原理并可以定制生成模板熟练运用 RBAC 权限模型和 Spring Security快速产出可用的业务模块提升开发效率二次开发的核心不是“完全依赖生成器”而是在其基础上进行定制和优化。建议先完全跑通一个生成模块再逐步深入改造源码最后尝试自定义生成器模板以适应不同业务场景。最后送上一句话用好若依你的开发速度至少提升 50%理解若依你的架构能力将更上一层楼。