Dromara RuoYi-Vue-Plus 是一个针对分布式集群与多租户场景设计的开源后台管理系统,基于 RuoYi-Vue 重写并全方位升级(不兼容原框架),专注于解决分布式环境下的复杂业务需求,且代码与文档完全开源免费可商用(遵循 MIT 协议,保留协议文件即可)。
软件架构图
核心信息
•版本与技术基础:当前版本 5.4.1,基于 Spring Boot 3.4 开发,支持 JDK 17 和 JDK 21。
•开源许可:MIT 协议,允许商用,需在项目中保留开源协议文件。
•Stars 与社区:累计 14.1K Stars,拥有活跃的开源社区,提供完善的文档和贡献机制。
核心特性与优势
1. 功能升级:全面超越原 RuoYi
功能 | 本框架实现 | 其他框架对比 |
|---|---|---|
数据分页 | 采用 Mybatis-Plus 分页插件,框架对其进行了扩展 对象化分页对象 支持多种方式传参 支持前端多排序 复杂排序 | 采用 PageHelper 仅支持单查询分页 参数只能从param传 只能单排序 功能扩展性差 体验不好 |
数据权限 | 采用 Mybatis-Plus 插件 自行分析拼接SQL 无感式过滤,只需为Mapper设置好注解条件 支持多种自定义 不限于部门角色 | 采用 注解+aop 实现 基于部门角色 生成的sql兼容性差 不支持其他业务扩展,生成sql后需手动拼接到具体业务sql上 对于多个Mapper查询不起作用 |
数据脱敏 | 采用 注解 + jackson 序列化期间脱敏 支持不同模块不同的脱敏条件,支持多种策略 如身份证、手机号、地址、邮箱、银行卡等 可自行扩展 | 无 |
数据加解密 | 采用 注解 + mybatis 拦截器 对存取数据期间自动加解密,支持多种策略 如BASE64、AES、RSA、SM2、SM4等 | 无 |
接口传输加密 | 采用 动态 AES + RSA 加密请求 body 每一次请求秘钥都不同大幅度降低可破解性 | 无 |
数据翻译 | 采用 注解 + jackson 序列化期间动态修改数据 数据进行翻译,支持多种模式: 映射翻译 直接翻译 其他扩展条件翻译 接口化两步即可完成自定义扩展 内置多种翻译实现 | 无 |
多数据源框架 | 采用 dynamic-datasource 支持市面大部分数据库,通过yml配置即可动态管理异构不同种类的数据库 也可通过前端页面添加数据源,支持spel表达式从请求头参数等条件切换数据源 | 基于 druid 手动编写代码配置数据源 配置繁琐 支持性差 |
多数据源事务 | 采用 dynamic-datasource 支持多数据源不同种类的数据库事务回滚 | 不支持 |
数据库连接池 | 采用 HikariCP Spring官方内置连接池 配置简单 以性能与稳定性闻名天下 | 采用 druid bug众多 社区维护差 活跃度低 配置众多繁琐性能一般 |
数据库主键 | 采用 雪花ID 基于时间戳的 有序增长 唯一ID 再也不用为分库分表 数据合并主键冲突重复而发愁 | 采用 数据库自增ID 支持数量有限 不支持多数据源主键唯一 |
WebSocket协议 | 基于 Spring 封装的 WebSocket 协议 扩展了Token鉴权与分布式会话同步 不再只是基于单机的废物 | 无 |
SSE推送 | 采用 Spring SSE 实现 扩展了Token鉴权与分布式会话同步 | 无 |
序列化 | 采用 Jackson Spring官方内置序列化 靠谱!!! | 采用 fastjson bugjson 远近闻名 |
分布式幂等 | 参考美团GTIS防重系统简化实现(细节可看文档) | 手动编写注解基于aop实现 |
功能 | 本框架实现 | 其他框架对比 |
|---|---|---|
数据分页 | 采用 Mybatis-Plus 分页插件,框架对其进行了扩展 对象化分页对象 支持多种方式传参 支持前端多排序 复杂排序 | 采用 PageHelper 仅支持单查询分页 参数只能从param传 只能单排序 功能扩展性差 体验不好 |
数据权限 | 采用 Mybatis-Plus 插件 自行分析拼接SQL 无感式过滤,只需为Mapper设置好注解条件 支持多种自定义 不限于部门角色 | 采用 注解+aop 实现 基于部门角色 生成的sql兼容性差 不支持其他业务扩展,生成sql后需手动拼接到具体业务sql上 对于多个Mapper查询不起作用 |
数据脱敏 | 采用 注解 + jackson 序列化期间脱敏 支持不同模块不同的脱敏条件,支持多种策略 如身份证、手机号、地址、邮箱、银行卡等 可自行扩展 | 无 |
数据加解密 | 采用 注解 + mybatis 拦截器 对存取数据期间自动加解密,支持多种策略 如BASE64、AES、RSA、SM2、SM4等 | 无 |
接口传输加密 | 采用 动态 AES + RSA 加密请求 body 每一次请求秘钥都不同大幅度降低可破解性 | 无 |
数据翻译 | 采用 注解 + jackson 序列化期间动态修改数据 数据进行翻译,支持多种模式: 映射翻译 直接翻译 其他扩展条件翻译 接口化两步即可完成自定义扩展 内置多种翻译实现 | 无 |
多数据源框架 | 采用 dynamic-datasource 支持市面大部分数据库,通过yml配置即可动态管理异构不同种类的数据库 也可通过前端页面添加数据源,支持spel表达式从请求头参数等条件切换数据源 | 基于 druid 手动编写代码配置数据源 配置繁琐 支持性差 |
多数据源事务 | 采用 dynamic-datasource 支持多数据源不同种类的数据库事务回滚 | 不支持 |
数据库连接池 | 采用 HikariCP Spring官方内置连接池 配置简单 以性能与稳定性闻名天下 | 采用 druid bug众多 社区维护差 活跃度低 配置众多繁琐性能一般 |
数据库主键 | 采用 雪花ID 基于时间戳的 有序增长 唯一ID 再也不用为分库分表 数据合并主键冲突重复而发愁 | 采用 数据库自增ID 支持数量有限 不支持多数据源主键唯一 |
WebSocket协议 | 基于 Spring 封装的 WebSocket 协议 扩展了Token鉴权与分布式会话同步 不再只是基于单机的废物 | 无 |
SSE推送 | 采用 Spring SSE 实现 扩展了Token鉴权与分布式会话同步 | 无 |
序列化 | 采用 Jackson Spring官方内置序列化 靠谱!!! | 采用 fastjson bugjson 远近闻名 |
分布式幂等 | 参考美团GTIS防重系统简化实现(细节可看文档) | 手动编写注解基于aop实现 |
分布式锁 | 采用 Lock4j 底层基于 Redisson | 无 |
分布式任务调度 | 采用 SnailJob 天生支持分布式 统一的管理中心 支持多种数据库 支持分片重试DAG任务流等等 | 采用 Quartz 基于数据库锁性能差 集群需要做很多配置与改造 |
文件存储 | 采用 Minio 分布式文件存储 天生支持多机、多硬盘、多分片、多副本存储,支持权限管理 安全可靠 文件可加密存储 | 采用 本机文件存储 文件裸漏 易丢失泄漏 不支持集群有单点效应 |
云存储 | 采用 AWS S3 协议客户端 支持 七牛、阿里、腾讯 等一切支持S3协议的厂家 | 不支持 |
短信 | 采用 sms4j 短信融合包 支持数十种短信厂家 只需在yml配置好厂家密钥即可使用 可多厂家共用 | 不支持 |
邮件 | 采用 mail-api 通用协议支持大部分邮件厂商 | 不支持 |
接口文档 | 采用 SpringDoc、javadoc 无注解零入侵基于java注释,只需把注释写好 无需再写一大堆的文档注解了 | 采用 Springfox 已停止维护 需要编写大量的注解来支持文档生成 |
校验框架 | 采用 Validation 支持注解与工具类校验 注解支持国际化 | 仅支持注解 且注解不支持国际化 |
Excel框架 | 采用 FastExcel(原Alibaba EasyExcel) 基于插件化,框架对其增加了很多功能 例如 自动合并相同内容 自动排列布局 字典翻译等 | 基于 POI 手写实现 功能有限 复杂 扩展性差 |
工作流支持 | 支持各种复杂审批 转办 委派 加减签 会签 或签 票签 等功能 | 无 |
工具类框架 | 采用 Hutool、Lombok 上百种工具覆盖90%的使用需求 基于注解自动生成 get set 等简化框架大量代码 | 手写工具稳定性差易出问题 工具数量有限 代码臃肿需自己手写 get set 等 |
监控框架 | 采用SpringBoot-Admin 基于SpringBoot官方 actuator 探针机制,实时监控服务状态 框架还为其扩展了在线日志查看监控 | 无 |
链路追踪 | 采用 Apache SkyWalking 还在为请求不知道去哪了 到哪出了问题而烦恼吗,用了它即可实时查看请求经过的每一处每一个节点 | 无 |
代码生成器 | 只需设计好表结构 一键生成所有crud代码与页面,降低80%的开发量 把精力都投入到业务设计上,框架为其适配MP、SpringDoc规范化代码 同时支持动态多数据源代码生成 | 代码生成原生结构 只支持单数据源生成 |
部署方式 | 支持 Docker 编排 一键搭建所有环境 让开发人员从此不再为搭建环境而烦恼 | 原生jar部署 其他环境需手动下载安装 自行搭建 |
项目路径修改 | 提供详细的修改方案文档 并为其做了一些改动 非常简单即可修改成自己想要的 | 需要做很多改造 文档说明有限 |
国际化 | 基于请求头动态返回不同语种的文本内容 开发难度低 有对应的工具类 支持大部分注解内容国际化 | 只提供基础功能 其他需自行编写扩展 |
代码单例测试 | 提供单例测试 使用方式编写方法与maven多环境单测插件 | 只提供基础功能 其他需自行编写扩展 |
Demo案例 | 提供框架功能的实际使用案例 单独一个模块提供了很多很全 | 无 |
2. 业务扩展:聚焦多租户与企业级需求
相比原 RuoYi,新增多项企业级业务功能:
3. 技术栈亮点
•工具集成:Hutool、Lombok 简化代码;Validation 支持国际化校验;FastExcel(原 EasyExcel)优化 Excel 处理。
•安全增强:接口传输动态加密(AES + RSA)、SQL 监控(p6spy)、分布式限流(Redisson)。
•兼容性:支持主从异构数据库、多数据源事务回滚,适配达梦、金仓等国产数据库。
使用与支持
文档与演示:
• 官方文档:https://plus-doc.dromara.org(含初始化、部署、贡献指南)。
• 系统演示:提供在线演示地址(文档内“传送门”),支持多租户登录场景。
前端项目:
• 官方及社区提供多个前端实现(基于 vben5、soybean 等)。
贡献与社区:
• 欢迎通过文档指引参与贡献,作者接受捐赠支持开源工作。
演示图例
总结
RuoYi-Vue-Plus 是面向分布式集群与多租户场景的企业级后台框架,在 RuoYi-Vue 基础上实现了技术栈升级、架构解耦和功能扩展,适合需要处理复杂权限、多终端接入、分布式部署的业务场景,且开源免费、文档完善,是学习和商用的优质选择。
项目地址
https://gitee.com/dromara/RuoYi-Vue-Plus