---

更新日志

重大更新

• [重大更新] 使用 caffeine 重构 PlusSaTokenDao 层实现 减少将近90%的redis查询提高性能

• [重大更新] 新增 PlusCacheWrapper 装饰器 为 SpringCache 增加本地缓存减少redis查询提高性能

• [重大更新] 升级 awsS3 到2.X版本 支持异步与自动分片上传下载(感谢 AprilWind)

• [重大更新] 新增 flowable 工作流功能(感谢 May)

• [重大更新] 新增 snailjob 调度中心 移除 powerjob (投诉的人太多) (感谢 dhb52)

• [重大更新] 重构 将spring-cloud-stream改为普通的mq依赖用法(感谢 Xbhog)

• [重大更新] 新增 ruoyi-common-bus 消息总线组件 基于MQ跨服务投递事件消息

依赖升级

• update springboot 3.1.7 => 3.2.6 支持虚拟线程

• update springboot-admin 3.1.8 => 3.2.3

• update springdoc 2.2.0 => 2.5.0

• update redisson 3.24.3 => 3.29.0 支持虚拟线程

• update hutool 5.8.22 => 5.8.26

• update dynamic-ds 4.2.0 => 4.3.0

• update mybatis-plus 3.5.4 => 3.5.7 修复与boot代码冲突问题

• update lock4j 2.2.5 => 2.2.7 消除启动警告

• update sms4j 2.2.0 => 3.2.1 支持自定义配置key 可用于多厂商多租户等

• update mapstruct-plus 1.3.5 => 1.3.6

• update easyexcel 3.3.3 => 3.3.4

• update lombok 1.18.30 => 1.18.32

• update satoken 1.37.0 -> 1.38.0

• update aws-oss 1.12.600 => 2.25.15

功能更新

• update 优化 StreamUtils 抽取 findFirst findAny 方法

• update 优化 更新使用 Spring 官方推荐 JDK

• update 优化 webscoket 配置与异常拦截

• update 优化 isTenantAdmin 空校验

• update 优化 修改路由name命名规则(感谢 玲娜贝er)

• update 优化 大数据量下join卡顿问题 使用子查询提高性能

• update 优化 用户ID查询角色列表(感谢 AprilWind)

• update 优化 获取用户账户(感谢 AprilWind)

• update 优化 租户列表接口 避免登录之后列表被域名过滤

• update 优化 三方登录不同域名获取不到租户id问题

• update 优化 获取aop代理的方式 减少与其他使用aop的功能冲突的概率

• update 优化 临时解决 spring 启动报 warn 问题

• update 优化 移除表单构建菜单(没有可用组件 用处不大以后再考虑)

• update 优化 修改用户信息接口(感谢 AprilWind)

• update 优化 切换动态租户 默认线程内切换(如需全局 手动传参)

• update 优化 适配最新前端代码生成模板

• update 优化 代码生成 el-radio 标签过期属性

• update 优化 文件下载(使用对流传递 降低内存使用量)(感谢 秋辞未寒)

• update 优化 去除gc日志参数(有需要自己加)

• update 优化 拆分异常处理器

• update 优化 常规web异常状态码

• update 优化 设置静态资源路径防止所有请求都可以访问静态资源

• update 优化 代码生成表导入 排除工作流相关表

• update 优化 redis 对Long值的存储类型不同问题

• update 优化 去除加密请求类型限制

• update 优化 mp多租户插件注入逻辑

• update 优化 移除删表语句 用户自行处理

• update 优化 RedisUtils 支持忽略租户

• update 更新 ip地址 xdb文件

• update 优化 新增修改菜单权限字符校验

• update 优化 验证码背景色改为浅灰色

• update 优化 更新 mybatis 多包扫描配置

• update 优化 RateLimiter 注解使用体验(感谢 ly-chn)

• update 优化 GET 方法响应体支持加密

• update 优化 excel 单元格合并可以基于注解选择需要依赖哪些字段(感谢 司猫子)

• update 优化 OssFactory 获取实例锁性能(感谢 fanc)

• update 优化 登录消息 支持集群发送

• update 优化 数据权限 使用预扫描mapper注解提升代码性能

• update 优化 数据加密 使用预扫描实体类提升代码性能(感谢 老马)

• update 优化 Async 针对虚拟线程配置 与其他注意事项注释

• update 优化 框架整体sql提高查询性能

• update 优化 将p6spy配置文件统一放置到 common-mybatis 插件包内

• update 优化 使用翻译注解简化用户查询 调整用户查询逻辑

新增功能

• add 新增 SMS异常处理器(感谢 AprilWind)

• add 新增 在线设备管理(个人中心)(感谢 AprilWind)

• add 新增 岗位编码与部门编码 并将岗位放到部门下(感谢 秋辞未寒)

• add 新增 分布式锁Lock4j异常拦截(感谢 AprilWind)

• add 新增 BaseMapperPlus提供一组可选是否抛出异常的selectVoOne方法(感谢 秋辞未寒)

• add 新增 用户、部门、角色、岗位 下拉选接口与代码实现优化

• add 新增 JustAuth 整合 TopIam 单点登录(感谢 马铃薯头)

• add 新增 StringUtils.isVirtual 方法

• add 新增 正则工具类 字符串提取 字符串校验

问题修复

• fix 修复 isLogin 方法抛异常无法正常返回值问题

• fix 修复 spring路径规则 导致 actuator 被特殊方式访问问题

• fix 修复token无效时关闭ws(感谢 AprilWind)

• fix 修复 oss未使用租户 拼接租户id null问题

• fix 修复 用户昵称修改后未清除对应缓存问题

• fix 修复 文件上传图片预览问题

• fix 修复 三方账号可以被同一个用户多次绑定问题

• fix 修复 兼容redis5.0出现的问题

• fix 修复 字典键值可重复配置问题

• fix 修复 部分浏览器无法获取加密响应头问题

• fix 修复 用户未设置部门 登录报错问题

• fix 修复 全局异常处理器 空指针null问题

• fix 修复 excel 表达式字典 下拉框导出格式错误

• fix 修复 InjectionMetaObjectHandler 已存在数据依旧会获取用户信息报异常问题

• fix 修复 关闭租户功能 三方登录报错问题

• fix 修复 部门树排序问题

• fix 修复 CryptoFilter 代码逻辑问题

前端改动

• update 升级 element vite 版本 最低nodejs版本提升到18.18.0

• update 优化 更改客户端状态接口 使用clientId传参

• update 优化 ws开关改为常开(vite5修复了崩溃bug)

• update 优化 移除cjs

• update 优化 对Volar支持

• update 优化 富文本组件，修复两个组件上传图片位置错乱问题

• update 优化 request请求类判断请求头方式

• update 优化 密码校验策略增加非法字符限制

• update 优化 支持全局开启或关闭接口加密功能

• update 优化 暗黑模式，增加vxe的暗黑模式

• update 优化 首页打开topNav不展开菜单问题

• update 优化 el-select 与 el-input 全局样式

• update 优化 跟密码相关的默认前端关闭防重功能

• add 新增 社交登录整合 TopIam

• add 新增 图片上传组件增加压缩功能支持，可自行开关

• add 新增 vxe-table依赖支持

• add 新增 全局用户选择组件

• add 新增 工作流相关页面与组件

• add 新增 使用bpmnjs流程预览

• add 新增 在线登录设备管理(感谢 AprilWind)

• add 新增 用户选择角色时 可搜索功能(感谢 追梦稻草人Li)

• fix 修复 登录失效，重新登录丢失参数问题(感谢 爱宇阳)

• fix 修复 websocket 非index页面刷新无法重连问题

• fix 修复 全局属性找不到的问题(感谢 ahaos)

• fix 修复 vue 类型识别问题

• fix 修复 富文本编辑器 单页面多实例图片混乱问题

• fix 修复 i18n无感刷新问题

• fix 修复 文件预览大写后缀不展示的问题(感谢 北桥)

• fix 修复 面板因为min width原因收缩不全

• fix 修复 移动端下 无法展开菜单问题

• fix 修复 菜单搜索下方出现白色区域

• fix 修复 el-tag标签类型不一致问题

• fix 修复 角色必填*号

微服务修改

• update springcloud 2022.0.4 => 2023.0.2

• update springcloud-alibaba 2022.0.0.0 => 2023.0.1.0

• update dubbo 3.2.7 => 3.2.14

• update easy-es 2.0.0-beta4 => 2.0.0 正式版

• update nacos 2.2.1 => 2.3.2 默认开启nacos服务端授权认证 (感谢 OldDriver9527)

• update rocketmq 4.9.4 => 5.2.0 docker镜像升级

• update kafka 3.2.0 => 3.6.2 docker镜像升级

• update rabbitmq 3.10.6 => 3.13.3 docker镜像升级

• update sentinel 1.8.6 => 1.8.8

• update skywalking 9.3.0 => 9.7.0

• update skywalking-agent 8.16.0 => 9.2.0

• update 优化 dubbo 使用 redis 作为元数据中心管理 支持过期时间 避免过期数据堆积 解放nacos存储空间

• update 优化 调整配置文件语法

• update 优化 使用spring工具自定义dubbo ip获取方法(针对多网卡ip获取不正确问题)

• update 优化 common-dubbo 删除无用依赖

• update 优化 去除重复的扫描器 @EnableDubbo 会自行扫描包

• update 优化 加密组件 mp依赖改为可选

• update 优化 mybatis依赖设置为可选依赖 避免出现不应该注入的情况

• fix 修复 sentinel-dashboard的pom引入logaback冲突问题

• fix 修复 nacos 不兼容 logback 1.4 新版本问题

• fix 修复 开启数据库加密 auth服务报错问题

• fix 修复 gateway sentinel 限流报错问题(临时方案) https://github.com/alibaba/Sentinel/issues/3298

平台简介

RuoYi-Cloud-Plus 微服务通用权限管理系统 重写 RuoYi-Cloud 全方位升级(不兼容原框架)

项目代码、文档 均开源免费可商用 遵循开源协议在项目中保留开源协议文件即可
活到老写到老 为兴趣而开源 为学习而开源 为让大家真正可以学到技术而开源

系统演示: https://plus-doc.dromara.org/#/common/demo_system

前端项目地址: https://gitee.com/JavaLionLi/plus-ui

文档地址: https://plus-doc.dromara.org

本框架与RuoYi的功能差异

功能	本框架	RuoYi
前端项目	基于vue3-element-admin开源项目重写 Vue3 + TS + ElementPlus	基于Vue2/Vue3 + JS
后端项目结构	采用插件化 + 扩展包形式 结构解耦 易于扩展	模块相互注入耦合严重难以扩展
后端代码风格	严格遵守Alibaba规范与项目统一配置的代码格式化	代码书写与常规结构不同阅读障碍大
分布式注册中心	采用 Alibaba Nacos 源码集成便于调试扩展与二次开发 框架还为其增加了各种监控	采用 Alibaba Nacos 自行搭建纯官方版本不可靠
分布式配置中心	采用 Alibaba Nacos 源码集成便于调试扩展与二次开发 框架还为其增加了各种监控	采用 Alibaba Nacos 自行搭建纯官方版本不可靠
服务网关	采用 SpringCloud Gateway 框架扩展了多种功能 例如:内网鉴权、请求体缓存、跨域配置、请求响应日志等	采用 SpringCloud Gateway 功能单一
负载均衡	采用 SpringCloud Loadbalancer 扩展支持了开发团队路由 便于多团队开发调试	采用 SpringCloud Loadbalancer 功能单一
RPC远程调用	采用 全新 Apache Dubbo 3.X 历史悠远不用多说	采用 feign 功能有限编写方式 网络波动大 不稳定
分布式限流熔断	采用 Alibaba Sentinel 源码集成便于调试扩展与二次开发 框架还为其增加了各种监控	采用 Alibaba Sentinel 自行搭建纯官方版本不可靠
分布式事务	采用 Alibaba Seata 源码集成对接了Nacos与各种监控 简化了搭建部署流程	采用 Alibaba Seata 自行搭建纯官方版本 搭建繁琐与Nacos不挂钩 代码内使用方式怪异等
Web容器	采用 Undertow 基于 XNIO 的高性能容器	采用 Tomcat
权限认证	采用 Sa-Token、Jwt 静态使用功能齐全 低耦合 高扩展	Spring Security 配置繁琐扩展性极差
权限注解	采用 Sa-Token 支持注解 登录校验、角色校验、权限校验、二级认证校验、HttpBasic校验、忽略校验 角色与权限校验支持多种条件 如 AND OR 或 权限 OR 角色 等复杂表达式	只支持是否存在匹配
关系数据库支持	原生支持 MySQL、Oracle、PostgreSQL、SQLServer 可同时使用异构切换	支持 Mysql、Oracle 不支持同时使用、不支持异构切换
缓存数据库	支持 Redis 5-7 支持大部分新功能特性 如 分布式限流、分布式队列	Redis 简单 get set 支持
Redis客户端	采用 Redisson Redis官方推荐 基于Netty的客户端工具 支持Redis 90%以上的命令 底层优化规避很多不正确的用法 例如: keys被转换为scan 支持单机、哨兵、单主集群、多主集群等模式	Lettuce + RedisTemplate 支持模式少 工具使用繁琐 连接池采用 common-pool Bug多经常性出问题
缓存注解	采用 Spring-Cache 注解 对其扩展了实现支持了更多功能 例如 过期时间 最大空闲时间 组最大长度等 只需一个注解即可完成数据自动缓存	需手动编写Redis代码逻辑
ORM框架	采用 Mybatis-Plus 基于对象几乎不用写SQL全java操作 功能强大插件众多 例如多租户插件 分页插件 乐观锁插件等等	采用 Mybatis 基于XML需要手写SQL
SQL监控	采用 p6spy 可输出完整SQL与执行时间监控	log输出 需手动拼接sql与参数无法快速查看调试问题
数据分页	采用 Mybatis-Plus 分页插件 框架对其进行了扩展 对象化分页对象 支持多种方式传参 支持前端多排序 复杂排序	采用 PageHelper 仅支持单查询分页 参数只能从param传 只能单排序 功能扩展性差 体验不好
数据权限	采用 Mybatis-Plus 插件 自行分析拼接SQL 无感式过滤 只需为Mapper设置好注解条件 支持多种自定义 不限于部门角色	采用 注解+aop 实现 基于部门角色 生成的sql兼容性差 不支持其他业务扩展 生成sql后需手动拼接到具体业务sql上 对于多个Mapper查询不起作用
数据脱敏	采用 注解 + jackson 序列化期间脱敏 支持不同模块不同的脱敏条件 支持多种策略 如身份证、手机号、地址、邮箱、银行卡等 可自行扩展	无
数据加解密	采用 注解 + mybatis 拦截器 对存取数据期间自动加解密 支持多种策略 如BASE64、AES、RSA、SM2、SM4等	无
数据翻译	采用 注解 + jackson 序列化期间动态修改数据 数据进行翻译 支持多种模式: 映射翻译 直接翻译 其他扩展条件翻译 接口化两步即可完成自定义扩展 内置多种翻译实现	无
多数据源框架	采用 dynamic-datasource 支持世面大部分数据库 通过yml配置即可动态管理异构不同种类的数据库 也可通过前端页面添加数据源 支持spel表达式从请求头参数等条件切换数据源	基于 druid 手动编写代码配置数据源 配置繁琐 支持性差
多数据源事务	采用 dynamic-datasource 支持多数据源不同种类的数据库事务回滚	不支持
数据库连接池	采用 HikariCP Spring官方内置连接池 配置简单 以性能与稳定性闻名天下	采用 druid bug众多 社区维护差 活跃度低 配置众多繁琐性能一般
数据库主键	采用 雪花ID 基于时间戳的 有序增长 唯一ID 再也不用为分库分表 数据合并主键冲突重复而发愁	采用 数据库自增ID 支持数据量有限 不支持多数据源主键唯一
WebSocket协议	基于 Spring 封装的 WebSocket 协议 扩展了Token鉴权与分布式会话同步 不再只是基于单机的废物	无
序列化	采用 Jackson Spring官方内置序列化 靠谱!!!	采用 fastjson bugjson 远近闻名
分布式幂等	参考美团GTIS防重系统简化实现(细节可看文档)	手动编写注解基于aop实现
分布式任务调度	采用 SnailJob 天生支持分布式 统一的管理中心 支持多种数据库 支持分片重试DAG任务流等	采用 Quartz 基于数据库锁性能差 集群需要做很多配置与改造
分布式日志中心	采用 ELK 业界成熟解决方案 实时收集所有服务的运行日志 快速发现定位问题	无
分布式搜索引擎	采用 ElasticSearch、Easy-Es 以 Mybatis-Plus 方式操作 ElasticSearch	无
分布式消息队列	采用 支持 Kafka、RocketMQ、RabbitMQ 各种 延迟消息 事务消息 流消息	无
分库分表功能	采用 Apache Sharding-Proxy 代理服务无入侵支持分库分表 只需编写分库分表规则即可	无
文件存储	采用 Minio 分布式文件存储 天生支持多机、多硬盘、多分片、多副本存储 支持权限管理 安全可靠 文件可加密存储	采用 本机文件存储 文件裸漏 易丢失泄漏 不支持集群有单点效应
云存储	采用 AWS S3 协议客户端 支持 七牛、阿里、腾讯 等一切支持S3协议的厂家	不支持
短信	支持 阿里、腾讯 只需在yml配置好厂家密钥即可使用 接口化支持扩展其他厂家	不支持
邮件	采用 mail-api 通用协议支持大部分邮件厂商	不支持
接口文档	采用 SpringDoc、javadoc 无注解零入侵基于java注释 只需把注释写好 无需再写一大堆的文档注解了	采用 Springfox 已停止维护 需要编写大量的注解来支持文档生成
校验框架	采用 Validation 支持注解与工具类校验 注解支持国际化	仅支持注解 且注解不支持国际化
Excel框架	采用 Alibaba EasyExcel 基于插件化 框架对其增加了很多功能 例如 自动合并相同内容 自动排列布局 字典翻译等	基于 POI 手写实现 功能有限 复杂 扩展性差
工具类框架	采用 Hutool、Lombok 上百种工具覆盖90%的使用需求 基于注解自动生成 get set 等简化框架大量代码	手写工具稳定性差易出问题 工具数量有限 代码臃肿需自己手写 get set 等
服务监控框架	采用 SpringBoot-Admin 基于SpringBoot官方 actuator 探针机制 实时监控服务状态 框架还为其扩展了在线日志查看监控	无
全方位监控报警	采用 Prometheus、Grafana 多样化采集 多模板大屏展示 实时报警监控 提供详细的搭建文档	无
链路追踪	采用 Apache SkyWalking 还在为请求不知道去哪了 到哪出了问题而烦恼吗 用了它即可实时查看请求经过的每一处每一个节点	无
代码生成器	只需设计好表结构 一键生成所有crud代码与页面 降低80%的开发量 把精力都投入到业务设计上 框架为其适配MP、SpringDoc规范化代码 同时支持动态多数据源代码生成	代码生成原生结构 只支持单数据源生成
部署方式	支持 Docker 编排 一键搭建所有环境 让开发人员从此不再为搭建环境而烦恼	原生jar部署 其他环境需手动下载安装 自行搭建
项目路径修改	提供详细的修改方案文档 并为其做了一些改动 非常简单即可修改成自己想要的	需要做很多改造 文档说明有限
国际化	基于请求头动态返回不同语种的文本内容 开发难度低 有对应的工具类 支持大部分注解内容国际化	只提供基础功能 其他需自行编写扩展
代码单例测试	提供单例测试 使用方式编写方法与maven多环境单测插件	只提供基础功能 其他需自行编写扩展
Demo案例	提供框架功能的实际使用案例 单独一个模块提供了很多很全	无

本框架与RuoYi的业务差异

业务	功能说明	本框架	RuoYi
租户管理	系统内租户的管理 如:租户套餐、过期时间、用户数量、企业信息等	支持	无
租户套餐管理	系统内租户所能使用的套餐管理 如:套餐内所包含的菜单等	支持	无
用户管理	用户的管理配置 如:新增用户、分配用户所属部门、角色、岗位等	支持	支持
部门管理	配置系统组织机构（公司、部门、小组） 树结构展现支持数据权限	支持	支持
岗位管理	配置系统用户所属担任职务	支持	支持
菜单管理	配置系统菜单、操作权限、按钮权限标识等	支持	支持
角色管理	角色菜单权限分配、设置角色按机构进行数据范围权限划分	支持	支持
字典管理	对系统中经常使用的一些较为固定的数据进行维护	支持	支持
参数管理	对系统动态配置常用参数	支持	支持
通知公告	系统通知公告信息发布维护	支持	支持
操作日志	系统正常操作日志记录和查询 系统异常信息日志记录和查询	支持	支持
登录日志	系统登录日志记录查询包含登录异常	支持	支持
文件管理	系统文件展示、上传、下载、删除等管理	支持	无
文件配置管理	系统文件上传、下载所需要的配置信息动态添加、修改、删除等管理	支持	无
在线用户管理	已登录系统的在线用户信息监控与强制踢出操作	支持	支持
定时任务	运行报表、任务管理(添加、修改、删除)、日志管理、执行器管理等	支持	仅支持任务与日志管理
代码生成	多数据源前后端代码的生成（java、html、xml、sql）支持CRUD下载	支持	仅支持单数据源
系统接口	根据业务代码自动生成相关的api接口文档	支持	支持
服务监控	监视集群系统CPU、内存、磁盘、堆栈、在线日志、Spring相关配置等	支持	仅支持单机CPU、内存、磁盘监控
缓存监控	对系统的缓存信息查询，命令统计等。	支持	支持
在线构建器	拖动表单元素生成相应的HTML代码。	支持	支持
使用案例	系统的一些功能案例	支持	不支持