Skip to content

🦁🦁🦁发布 6.0.0 正式版 大版本发布!!!

Latest
Latest

Choose a tag to compare

View all tags
@CrazyLionCat CrazyLionCat released this 30 Jul 03:11
v6.0.0
7180b52

项目更新日志

🔴 重大更新

  1. 不兼容整体升级 SpringBoot 4.X 全系列生态
  2. 增加 MyBatis-Plus 扩展工具，大幅简化整体业务代码写法
  3. 集成 MyBatis-Plus-Join 重构项目代码
  4. 重写翻译和脱敏实现，使用 Jackson tree 解析 + ResponseBodyAdvice 批量翻译，效率大幅提升
  5. 数据权限增加角色与菜单关联，实现 角色->菜单->数据权限 精细化控制
  6. 提炼所有通用 Service 接口与实体类为 ruoyi-api 模块，通用性与扩展性增强
  7. 全局将 Date 替换为 LocalDateTime 时间类型
  8. 合并 common-sse / common-websocket 为 ruoyi-common-push 推送模块
  9. 整体移除多租户相关功能
  10. 集成 snail-ai，并新增 ruoyi-snailai-server 独立服务

📦 依赖更新

  1. SpringBoot 4.1 全版本升级
  2. SpringBoot-Admin 4.1
  3. Springdoc 3.0.2
  4. Redisson 4.6.1
  5. dynamic-ds 4.5.0
  6. AWS-SDK 2.42.9
  7. bcpkix-jdk18on 1.84
  8. Spring AI 2.0.0
  9. snail-ai 1.1.1
  10. snailjob 2.0.2
  11. warm-flow 1.8.9
  12. MySQL 8.0.42 → 8.4.9
  13. Nginx 1.23.4 → 1.31.1
  14. Redis 7.2.8 → 8.6.3
  15. Minio 升级至 RELEASE.2026-04-17T00-00-00Z
  16. JDK 版本更新至 21.0.12（Dockerfile 同步适配）
  17. FastExcel 迁移至 Apache Fesod

🆕 功能新增

  1. 新增 ruoyi-snailai-server 独立服务，提供 snail-ai 企业级 AI Agent 平台整合
  2. 新增 ruoyi-common-mcp 模块，支持 MCP 服务端/客户端
  3. 新增 ruoyi-common-mqtt 消息推送模块
  4. 新增 ruoyi-common-elasticsearch 模块，支持 ES 开发
  5. 新增 AI 编程支持（codex、claude）
  6. 新增 SQL join 工具，简化业务代码
  7. 新增 链式查询函数、聚合函数、子查询支持
  8. 新增 R.data 方法，解决 R 等泛型返回问题
  9. 新增 maven-wrapper，保证项目构建环境一致
  10. 新增 Spring AI、snail-ai 相关 Docker / Run 配置
  11. 新增 公共基础模块开发规范与 AI Agent 辅助文档
  12. 新增 自定义sql日志输出 性能比p6spy更好更详细 可以精确定位mapper具体位置
  13. 新增 ruoyi-common-liteflow 规则引擎模块，统一 LiteFlow 依赖、执行工具和公共规则节点

☁️ Cloud 版本单独更新

  1. 不兼容整体升级 Spring Cloud 2025.1.2、Spring Cloud Alibaba 2025.1，适配 SpringBoot 4.X 微服务生态
  2. 升级 Nacos 至 3.2.2、Seata 至 2.6.0，并调整 Nacos / Seata 部署方式，因底层结构变化不再内置维护源码服务，改为使用者自行下载搭建
  3. 删除 Gateway WebFlux 版本，统一使用 MVC Gateway，降低网关维护复杂度并统一异常处理行为
  4. 集成 snail-ai-server，并新增 ruoyi-ai 服务，补充对应 Run / Docker 配置
  5. 增加 Spring Cloud Bus Redis 实现，workflow 模块默认可使用 Redis 作为事件中心，降低对 MQ 的强依赖
  6. 优化 Dubbo 相关适配，修复 JDK 25 SPI 加载兼容问题、Dubbo 元数据处理异常，以及远程调用中手动使用虚拟线程导致上下文丢失的问题
  7. 优化微服务远程接口与 API 模块，调整 RemoteMessageService、RemotePushPayLoad、RemoteLoginInfo 等远程调用对象与包结构
  8. 升级并适配微服务周边组件：Elasticsearch / Kibana / Logstash 8.19.16、RocketMQ 5.5.0、RocketMQ Spring Boot Starter 2.3.5、Kafka 4.3.0
  9. 升级监控链路：SkyWalking OAP / UI 10.4.0、Java Agent 9.6.0、Prometheus 3.12.0、Grafana 13.0.2
  10. 更新 Grafana 看板，替换旧 Spring Boot 2.1 看板为 Spring Boot 3.x Statistics，并补充 Nacos 与 JVM Micrometer 看板模板说明
  11. 调整 Elasticsearch 默认关闭认证，并保留启用认证初始化说明；适配 Logstash 输出到 Elasticsearch 8.x 的 hosts 配置
  12. 优化 Gateway 默认请求头覆盖逻辑，修复 MVC 网关与 Flux 网关异常返回内容不一致问题
  13. 修复 Cloud 配置文件路径错误、Spring 包名调整导致的启动异常等微服务版本适配问题

✨ 功能优化

代码规范与可读性

  1. 简化类型检查、优化代码格式、简化条件判断
  2. 使用 getFirst() 替代 get(0)，提升代码可读性
  3. 规范 Mapper / DTO 命名，统一 bo 对象结构
  4. 统一用户性别字段 gender、统一系统用词
  5. 全模块补充注释，增强代码可维护性
  6. 使用常量替代硬编码状态值
  7. 全局格式化代码、清理冗余分隔符、消除编译警告
  8. 新增上传附件保存扩展信息
  9. 未知异常和系统异常增加随机编号方便查找
  10. 重构将代码生成vm模板替换为fm模板 语法更清晰明了

核心功能优化

  1. 代码生成器：支持多前端模板、自动数据库类型映射、自定义路径导出、清理无用代码
  2. 公共模块：重构 common-core / common-web / common-json / common-mybatis / common-redis / common-oss / common-excel / common-encrypt 等基础能力
  3. 数据访问：引入 MyBatis-Plus 扩展工具与 MPJ，优化分页、数据权限、联表查询和 Mapper 处理逻辑
  4. 翻译脱敏：重写翻译与脱敏链路，支持批量翻译、缓存解析结果，减少重复序列化
  5. 登录认证：优化登录异常提示、客户端 ID 与 Token 不匹配提示，统一 SSE/WS 认证处理
  6. 工作流：优化审批逻辑、批量翻译、撤销权限控制、防 XSS 过滤和流程图提示查询性能
  7. 工作流规则编排：基于 LiteFlow 重构流程发起、任务办理、任务操作和流程实例删除链路，拆分规则 XML、上下文和业务节点，提升复杂流程编排可读性
  8. Excel：重构导入导出构建器，大数据量导出支持多线程 ZIP 打包，优化导入转换逻辑
  9. OSS：重构客户端生命周期，新增 S3 客户端，优化配置管理、路径风格和下载处理
  10. 消息推送：扩展消息类型/来源/跳转路径，完成消息盒子前后端联动
  11. 接口响应：统一 R 类型返回，优化路由数据与 ext 扩展数据，清理无用接口
  12. 性能：优化菜单树构建、虚拟线程查询、任务处理器转换和批量远程调用逻辑

其他优化

  1. 优化 日期解析、LocalDateTime 序列化和代码生成器时间类型
  2. 优化 Redis 工具类、缓存管理、加解密逻辑，并将 idempotent / ratelimiter 能力合并进 redis 模块
  3. 优化 头像上传改为先上传 OSS 后更新用户数据
  4. 优化 Dockerfile、Docker 配置、README 和项目文档
  5. 优化 调整系统标题、描述、AI 页面路径及相关展示文案
  6. 优化 安全相关工具类，增加 SM2 验签能力
  7. 优化 日志参数字段排除处理 采用更好的JsonNode节点树处理 性能更好 避免报错
  8. 优化 岗位表增加逻辑删除字段
  9. 重写 s3 授权签名 支持私有库自定义域名

🐛 功能修复

  1. 修复 代码生成默认菜单上级 ID 错误
  2. 修复 大文件分片断点续传失败问题
  3. 修复 OSS 路径风格、配置切换、文件下载异常
  4. 修复 多次驳回无法锁定审批人问题
  5. 修复 “我的已办”接口报错问题
  6. 修复 多数据库 SQL 语法兼容问题
  7. 修复 前端输入性 CVE 漏洞，禁止代码生成到本地路径
  8. 修复 手机号/邮箱格式校验错误
  9. 修复 DeptExcelConverter 内存泄漏问题
  10. 修复 接口文档、Mapper 执行异常
  11. 修复 登录日志路由名错误
  12. 修复 租户删除后 SQL 执行异常
  13. 修复 短信/邮箱验证码发送失败后仍写入缓存等异常场景
  14. 修复 ValidatorUtils 空指针校验、重复提交切面过滤对象扫描等边界问题
  15. 修复 Excel 级联下拉一级选项名称规则校验和重复校验问题

前端修改内容

  1. 技术栈升级：升级 Vue、Vue Router、Element Plus、Vite、UnoCSS、Sass、vue-tsc、Oxlint 等前端核心依赖，并适配类型检查、键盘事件和 Sass 命名空间写法
  2. 工程化调整：由 npm 迁移至 pnpm，使用 oxfmt / Oxlint 替代 Prettier / ESLint，新增 pnpm-lock.yaml，清理旧构建脚本与过时配置
  3. 主题样式重构：整体主题样式重写为卡片式布局，拆分 SCSS 文件，统一暗黑模式颜色、圆角变量、Element Plus 组件样式和页面壳样式
  4. 布局与标签页：优化 TagsView 左右滚动、右侧下拉、单独刷新、全屏显示、持久化标签页、快速刷新 404 和动态路由缓存清理问题
  5. 菜单与路由：重写菜单搜索，优化动态路由组件解析性能，支持路由 ext 扩展数据，菜单管理增加类型、激活菜单、隐藏和禁用图标展示
  6. 消息推送：适配 common-push，移除旧 SSE / WebSocket 工具，新增统一 push 工具、消息类型/来源/跳转路径、消息盒子分组与已读未读联动
  7. AI 功能：新增 snail-ai 集成与 AI 聊天页面，补充 AI Agent API、聊天输入区、主面板和侧边栏模块
  8. 代码生成器：新增前端代码生成模板，支持多前端模板选择，适配后端生成器增强字段、导出、状态切换、排序、组合唯一校验等配置
  9. 系统管理页面：优化用户、角色、菜单、部门、字典、客户端、OSS、通知公告等页面，新增用户详情抽屉、客户端白名单路径/IP、角色菜单权限与数据权限整合
  10. 工作流页面：优化流程定义、流程实例、待办/已办/抄送、审批记录、办理人展示和设计器页面，新增工作流权限标识符适配
  11. 上传与富文本：优化文件/图片上传 token 过期处理和 loading 关闭问题，富文本编辑器改用 wangeditor-next，并增加富文本内容 XSS 过滤与 OSS 内容解析工具
  12. 通用组件与 Hooks：新增 TreePanel、UserNameDisplay、useLoading、useFormDialog、useSearchToggle、useTableSelection、useTreeCollapsed 等通用组件与 hooks，简化页面编码
  13. 安全与数据处理：登录“记住我”仅保存用户名和 rememberMe 并清理历史明文密码缓存，修复默认密码覆盖、雪花 ID 精度丢失、前端输入性 CVE 等问题
  14. 性能与稳定性：优化 loadView 查找、generateRoutes 克隆、useDict 并发去重、上传 headers 响应式、TagsView 内存泄漏、ECharts resize 监听和 SSE watcher 清理
  15. 功能修复：修复 SvgIcon 空图标白屏、图标选择 Tooltip 错位、字典筛选框图标状态、部门树禁用部门不显示、文件下载异常、表单滚动背景透明、OSS 配置状态等问题

React 前端版本（plus-ui-react）

  1. 新增官方 React 前端版本 plus-ui-react，作为 6.X 前端可选实现，适配 RuoYi-Vue-Plus 后端接口与权限体系
  2. 技术栈采用 React 19 + TypeScript + Ant Design + Umi Max + Vite，配套 Zustand、TanStack Query、Ahooks、ECharts、WangEditor-Next、Ant Design Pro Components 等生态
  3. 工程链路统一使用 pnpm、oxfmt、Oxlint、TypeScript 6、OpenAPI，要求 Node >= 20、pnpm >= 10，提升构建、格式化、类型检查和接口类型维护效率
  4. 完成后台基础能力适配，覆盖登录认证、动态路由、菜单权限、字典、参数、通知公告、文件管理、在线用户、操作日志、登录日志、缓存监控等常用模块
  5. 完成系统管理核心页面适配，支持用户管理、角色管理、菜单管理、部门管理、岗位管理、客户端管理、OSS 文件与配置管理等功能
  6. 完成工作流相关页面适配，支持流程分类、流程定义、流程实例、待办、已办、抄送、审批记录、流程图和流程设计器等业务场景
  7. 新增 AI 聊天页面与 AI Agent 接口适配，支持 6.X snail-ai 能力在 React 前端中展示与使用
  8. 新增消息盒子与消息推送能力，支持消息类型、消息来源、跳转路径、已读未读状态等交互
  9. 新增通用组件与业务组件封装，包括 TagsView、菜单搜索、布局设置、树面板、用户选择、文件/图片上传、富文本编辑、JSON 展示、审批组件等
  10. 新增通用 hooks 与工具封装，覆盖字典加载、日期范围查询、表格选择、导出、树表展开、上传处理、权限校验、菜单处理、XSS 过滤等常见场景
  11. 移除多租户相关前端页面与接口，保持与 6.X 后端整体移除多租户的架构一致
  12. React 版本与 Vue 版本并行维护，开发者可根据团队技术栈选择 Vue + Element Plus 或 React + Ant Design 前端实现
Assets 2
Loading