---

更新日志

重大更新

• 重构数据权限实现逻辑 支持任意mapper方法标注注解 无需再找真实mapper标注

• 重写工作流模块 接入warm-flow工作流 移除flowable工作流(过于复杂 用不明白的人太多)

依赖升级

• update springboot 3.2.11 => 3.4.1

• update springboot-admin 3.2.3 => 3.4.1

• update mybatis-plus 3.5.8 => 3.5.9

• update snailjob 1.1.2 => 1.3.0(感谢 dhb52)

• update springdoc 2.6.0 => 2.8.3

• update redisson 3.37.0 => 3.43.0

• update justauth 1.16.6 => 1.16.7 支持多种登录方式 不限于三方登录

• update mybatis-plus 3.5.9 => 3.5.10

• update hutool 5.8.31 => 5.8.35

• update mapstruct-plus 1.4.5 => 1.4.6

• update lombok 1.18.34 => 1.18.36

• update anyline 20241022 => 20250101

功能更新

• update 优化 查询oss图片url接口改为query标识符

• update 优化 绑定三方与解绑三方校验token是否存在

• update 优化 OSS私有桶的临时URL获取方法(感谢 秋辞未寒)

• update 优化 ws模块替换session的时候关闭session连接

• update 优化 数据权限 判断当前注解不满足模板则跳过

• update 优化 使用request存储动态租户 避免单请求多次查询redis获取

• update 优化 修改部门信息增加事务(感谢 AprilWind)

• update 优化 增加菜单选择拓展参数(感谢 玲娜贝er)

• update 优化 jdk21环境开启虚拟线程时的定时任务池(感谢 秋辞未寒)

• update 优化 sse 如果获取token列表为空 删除userid对应的存储

• update 优化 数据权限处理器 增加默认值处理 针对于表达式变量与注解不对应或者表达式变量为null的情况

• update 优化 关闭sse后 使用工具报错

• update 优化 增加mybatis-plus一键开启/关闭逻辑删除功能

• update 优化 修改日志时间展示颜色(感谢 疯狂的牛子Li)

• update 适配 TOPIAM 2.0 单点登录(感谢 马铃薯头)

• update 优化 完善微信小程序登录接口逻辑

• update 优化 重构DateUtils工具类 更加实用

• update 优化 为部门角色岗位用户增加一些常用查询方法

• update 优化 登录用户增加岗位数据

• update 优化 去除部门查询状态校验 改为前端过滤 便于查看禁用部门下的其他数据

• update 优化 部门树增加禁用标志位

• update 优化 workflow 模块增加接口文档生成功能

• update 优化 代码生成 增加buildQueryWrapper默认排序规则

• update 优化 代码生成 创建更新时间被覆盖问题

• update 优化 代码生成排序问题(感谢 AprilWind)

• update 优化 在线用户查询 优先查询租户下数据 减少数据量

• update 优化 租户域名使用忽略大小写匹配

• update 优化 代码生成器 将数据库字段默认转为小写 避免某些数据库大写出现的问题

• update 优化 由于sse重试机制导致经常输出认证失败日志过多 将sse失败改为debug

• update 优化 有界队列销毁方式 应该使用特殊销毁方法

• update 优化 redis序列化 支持更快的apache二进制跨语言序列化方案

• update 优化 租户日志模块名

• update 优化 增加默认数据权限 "部门及以下或本人数据权限" 选项

• update 优化 代码生成器 pg数据库 主键获取不精确问题

• update 优化 代码生成器类型获取

• update 优化 个人中心强退设备接口路径

• update 优化 Dockerfile 消除warn警告

• update 优化 补充客户端工具类注释(感谢 AprilWind)

• update 优化 补充Undertow自定义配置信息注释(感谢 AprilWind)

• update 优化 拦截爬虫跟踪等垃圾请求

• update 优化 将Log记录异常长度改为5000

• update 优化 将Log记录参数长度扩充为5000更符合实际需求

• update 优化 xss包装器 Parameter 处理 兼容某些容器不允许改参数的情况

• update 优化 支持脱敏传多角色多权限标识

• update 优化 角色删除清理缓存

• update 优化 使用ObjectUtils新增方法封装代码

• update 优化 数据权限查询增加缓存

• update 优化 代码生成器数字类别判断

• update 优化 逻辑删除状态改为1 避免误解

• update 重构 将UserConstants改为SystemConstants 统一常量使用 降低使用难度避免误解

• update 优化 封装部门基于父id查询方法

• update 优化 不传用户id不校验数据权限

• update 优化 部门树多基点展示问题 支持相同名称节点并排展示

• update 优化 去除OSS桶检测 桶不存在自然会报错无需额外检测

• update 优化 限流注解增加固定清理时间

• update 优化 sys_social表 租户id增加默认值

• update 优化 jackson 过期方法

• update 优化 多租户插件初始化流程

• update 优化 去除GenUtils设置createby逻辑 统一走自动注入设置

• update 优化 替换RedisUtils中的废弃方法getKeysStreamByPattern及trySetRate(感谢 Lucien_Lu)

• update 优化 删除桶自动创建代码逻辑(云厂商限制不允许操作桶)

• update 优化 角色清理在线用户代码逻辑

功能新增

• add 新增 导出模板必填、备注注解实现(感谢 liyang)

• add 新增 基于Redisson的发号器工具(感谢 秋辞未寒)

• add 新增 validation支持枚举校验(感谢 秋辞未寒)

• add 新增 validation支持枚举校验(感谢 秋辞未寒)

• add 新增 对象工具类(感谢 秋辞未寒)

• add 增加 邮件多附件demo

问题修复

• fix 修复 文件下载 设置content-length无效问题

• fix 修复 satoken dao层获取timeout为秒导致丢失毫秒进度问题(临时修复 等satoken官方解决)

• fix 修复 postgresql的表元数据没有创建时间这个东西(好奇葩) 只能new Date代替

• fix 修复 数据权限 多角色多注解包含忽略权限标识符逻辑不正确问题

• fix 修复 未开启sse 找不到bean问题

• fix 修复 数据权限导致的个人中心的修改头像和修改密码接口错误(感谢 QianRj)

• fix 修复 部门数据权限缓存错误(感谢 QianRj)

• fix 修复 三方授权工具部分网站授权缺失参数问题

• fix 修复 代码生成 表名中间带有特殊字符被过滤问题 改为开头过滤

• fix 修复 字段长度超出数据库限制问题

• fix 修复 过滤器正则错误

• fix 修复 monitor 设置 context-path 导致退出重新登录404问题

• fix 修复 数据权限多角色与权限标识符共用导致的问题 https://gitee.com/dromara/RuoYi-Vue-Plus/issues/IB4CS4

• fix 修复 排除websocket包内包含的tomcat依赖(导致一些问题)

• fix 修复 PageQuery 转json报错问题

• fix 修复 sse 关闭接口无法断连问题

• fix 修复 PlusSmsDao#clean 方法书写错误

• fix 修复 excel级联下拉框数据错误(感谢 Emil.Zhang)

• fix 修复 某些模块不存在 mp 依赖导致方法报错问题

• fix 修复 新版本mp默认使用最新 sqlserver 语法导致代码生成分页报错问题

• fix 修复 OssClient 回滚错误修改

• fix 修复 注册日志记录状态错误

前端改动

• update typescript 5.4.5 => 5.7.2

• update vite 5.2.12 => 5.4.11

• update vue 3.4.34 => 3.5.13

• update element-plus 2.7.8 => 2.8.8

• update eslint 升级v9版本(感谢 玲娜贝er)

• update vue-i18n 10.0.5

• update 优化 parseTime 提示报错问题

• update 优化 国际化 变量提示

• update 优化 重写工作流相关页面

• update 优化 主题色在深色模式下显示亮度(感谢 LiuHao)

• update 优化 hasRoles 方法增加超管判断

• update 优化 用户页面 增加导入到处权限标识

• update 优化 TopNav内链菜单点击没有高亮

• update 优化 新增编辑用户 过滤禁用的部门

• update 优化 白名单增加正则匹配示例

• update 优化 白名单支持对通配符路径匹配

• update 优化 i18n $t方法支持ts类型提示(感谢 玲娜贝er)

• update 优化 登录页多语言按钮样式

• update 优化 补充登录页与注册页的国际化内容并添加切换语言按钮(感谢 QianRj)

• update 优化 eslint升级v9版本 & 更新一些不符合校验规则的代码(感谢 玲娜贝er)

• update 优化 全代码规范化处理

• update 优化 代码生成导入下拉框默认值处理

• update 优化 菜单面包屑导航支持多层级显示

• update 优化 参数键值更换为多行文本

• update 优化 增加默认数据权限 "部门及以下或本人数据权限" 选项

• update 优化 permission loadView避免整个modules循环 允许view中间有views文件夹(感谢 admin_lijinfu)

• update 优化 个人中心强退设备接口路径

• update 优化 直接从@/lang/*.ts后缀的i18n文件中读取各国语言包信息(感谢 QianRj)

• update 优化 将同步字典功能迁移到租户管理内

• update 优化 重构操作日志详情样式(感谢 玲娜贝er)

• update 优化 字典缓存使用Map代替Array更高效(感谢 月夜)

• update 优化 校检文件名是否包含特殊字符

• update 优化 getTenantList 接口动态决定是否传token

• fix 修复 切换租户 tabs过多导致卡住问题

• fix 修复 用户管理界面修改按钮权限字符串错误(感谢 QianRj)

• fix 修复 oss配置页 展示配置key 隐藏主键id

• fix 修复 页面api过期警告

• fix 修复 代码生成列表加载问题你

• fix 修复 修复默认关闭Tags-Views时，内链页面打不开

• fix 修复 用户选择组件 id类型不统一问题

• fix 修复 代码生成 编辑之后查两遍列表的问题

• fix 修复 登录无redirect参数404问题

• fix 修复 monitor 设置 context-path 导致退出重新登录404问题

• fix 修复 手动登出与token过期登出跳转行为不一致问题

• fix 修复 关闭sse功能 登出还是会发送sse关闭请求导致报错问题

• fix 修复 内嵌页面数据缓存导致与外部页面不一致问题

平台简介

RuoYi-Vue-Plus 是重写 RuoYi-Vue 针对 分布式集群与多租户 场景全方位升级(不兼容原框架)

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

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

前端项目地址: https://gitee.com/JavaLionLi/plus-ui
成员前端项目地址: 基于vben5 https://gitee.com/dapppp/ruoyi-plus-vben5

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

本框架与RuoYi的功能差异

功能	本框架	RuoYi
前端项目	采用 Vue3 + TS + ElementPlus 重写	基于Vue2/Vue3 + JS
后端项目结构	采用插件化 + 扩展包形式 结构解耦 易于扩展	模块相互注入耦合严重难以扩展
后端代码风格	严格遵守Alibaba规范与项目统一配置的代码格式化	代码书写与常规结构不同阅读障碍大
Web容器	采用 Undertow 基于 XNIO 的高性能容器	采用 Tomcat
权限认证	采用 Sa-Token、Jwt 静态使用功能齐全 低耦合 高扩展	Spring Security 配置繁琐扩展性极差
权限注解	采用 Sa-Token 支持注解 登录校验、角色校验、权限校验、二级认证校验、HttpBasic校验、忽略校验 角色与权限校验支持多种条件 如 AND OR 或 权限 OR 角色 等复杂表达式	只支持是否存在匹配
三方鉴权	采用 JustAuth 第三方登录组件 支持微信、钉钉等数十种三方认证	无
关系数据库支持	原生支持 MySQL、Oracle、PostgreSQL、SQLServer 可同时使用异构切换(支持其他 mybatis-plus 支持的所有数据库 只需要增加jdbc依赖即可使用 达梦金仓等均有成功案例)	支持 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等	无
接口传输加密	采用 动态 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框架	采用 Alibaba EasyExcel 基于插件化 框架对其增加了很多功能 例如 自动合并相同内容 自动排列布局 字典翻译等	基于 POI 手写实现 功能有限 复杂 扩展性差
工作流支持	支持各种复杂审批 转办 委派 加减签 会签 或签 票签 等功能	无
工具类框架	采用 Hutool、Lombok 上百种工具覆盖90%的使用需求 基于注解自动生成 get set 等简化框架大量代码	手写工具稳定性差易出问题 工具数量有限 代码臃肿需自己手写 get set 等
监控框架	采用 SpringBoot-Admin 基于SpringBoot官方 actuator 探针机制 实时监控服务状态 框架还为其扩展了在线日志查看监控	无
链路追踪	采用 Apache SkyWalking 还在为请求不知道去哪了 到哪出了问题而烦恼吗 用了它即可实时查看请求经过的每一处每一个节点	无
代码生成器	只需设计好表结构 一键生成所有crud代码与页面 降低80%的开发量 把精力都投入到业务设计上 框架为其适配MP、SpringDoc规范化代码 同时支持动态多数据源代码生成	代码生成原生结构 只支持单数据源生成
部署方式	支持 Docker 编排 一键搭建所有环境 让开发人员从此不再为搭建环境而烦恼	原生jar部署 其他环境需手动下载安装 自行搭建
项目路径修改	提供详细的修改方案文档 并为其做了一些改动 非常简单即可修改成自己想要的	需要做很多改造 文档说明有限
国际化	基于请求头动态返回不同语种的文本内容 开发难度低 有对应的工具类 支持大部分注解内容国际化	只提供基础功能 其他需自行编写扩展
代码单例测试	提供单例测试 使用方式编写方法与maven多环境单测插件	只提供基础功能 其他需自行编写扩展
Demo案例	提供框架功能的实际使用案例 单独一个模块提供了很多很全	无

本框架与RuoYi的业务差异

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