更新日志

当前版本： v1.8.0

v1.8.0 (2026-04-26)

新特性

• 新增：添加级联属性支持，包含 Form 表单、Table 表格、ExcelImport 导入、ExcelExport、 Validate 数据验证 等组件和工具类
• 新增：Table 表格 组件添加悬浮操作栏
• 新增：Table 表格 组件内存分页的 Column 新增对 sort-method 和 sort-by 的支持
• 新增：系统日志及在线用户信息现已支持显示用户的登录设备类型
• 新增：后端 BaseJdbcDao 的 update 方法添加列选取器参数，支持仅选取部分列进行更新，且更新操作现在会返回数据库实际执行的更新行数

优化

• 调整：不兼容调整 BaseJdbcDao 重构，不再支持单个实例操作多数据源数据。相关的指定数据源操作方法均已删除，现创建实例时需明确传入数据源；如需操作多数据源，请创建多个 BaseJdbcDao 实例
• 优化：删除后端的 common-jdbc 模块，并将其核心功能并入 common-core 模块
• 优化：代码生成器增强，如果生成字段为日期时间类型，简易查询中将自动生成独立的日期时间范围查询组件
• 优化：代码生成器现在会自动为 Table 表格 组件生成 persist-layout-key 属性，默认开启表格列布局保持功能
• 优化：用户登录时，如果账户被锁定且原因为空，系统将给出默认的锁定原因提示
• 优化：后端 EntityColumnStaff 提取至独立文件，并优化了底层实现细节
• 优化：优化部分前端代码逻辑
• 修复：修复 Table 表格 组件在多级表头场景下数据列显示错乱的问题
• 修复：修复 ExcelImport 导入 组件在 on-complete 回调中，数据字典类型数据没有被正确转化的问题
• 修复：修复代码生成器生成的 DTO 实体中，title 字段错误被设置为 columnName 的问题
• 修复：修复 checkDataPermissionByIds 代码生成器的错误问题
• 修复：修复后端系统日志中，请求体和响应体内容丢失无法保存的问题

升级

• 升级：重要 前端 vite 升级至 8.0 版本，全面拥抱 Oxc 生态；typescript 升级至 6.0 版本
• 升级：重要 后端核心依赖大版本升级：SpringBoot 升级至 4.0，JDK 升级至 25，Jackson 升级至 3 ；全面替换部分过时API，同时IP解析现已完整支持 IPv6
• 升级：前端相关依赖升级至最新版本，并修复了部分 ts 告警信息

文档

• 更新：更新数据库初始化 SQL 语句
• 修复：修复文档中的部分错误描述，并补充了缺失的组件属性说明文档

v1.7.0 (2025-11-01)

新特性

• 新增：Table 表格 组件新增 persist-layout-key 属性，指定项目全局唯一的key，用户可以持久化保存表格的列布局：包括列显隐，列宽，列顺序，列固定等设置
• 新增：Form 表单 组件新增 newline 属性，不管上一行是否有足够空间容纳，该表单项始终从新行开始
• 新增：Form 表单 组件新增 colSize 属性，用于手动指定单个表单项的最大宽度，用于动态计算一行可容纳表单项的数量
• 新增：Table 表格 组件新增支持内存分页排序
• 新增：后端增强数据权限校验逻辑，防止用户篡改ID访问接口来越权访问数据，现在越权访问时将抛出异常，并且现在数据权限必须明确指定才能访问数据，若未维护数据权限，则认定无数据权限，在此之前未维护数据权限默认可查看所有，数据访问更加安全
• 新增：数据权限表达式可为空，表示具有所有权限

优化

• 调整：不兼容调整 Table 表格 is-sort-column 已修改为 show-setting，需手动全局更改属性名
• 优化：代码生成编辑列时，当列属性名为空，填入字段名自动生成属性名
• 优化：代码生成器查询表名默认别名 a
• 优化：Form 表单 组件新增组件属性提示方便开发
• 修复：当菜单类型为 iframe 时，页签切换缓存失效的问题
• 修复：代码生成表单无法启用数据权限的问题
• 修复：代码生成 BaseEntity 错误
• 修复：系统菜单禁用失效的问题
• 修复：后端无权限异常返回 status 丢失的问题
• 修复：后端 MysqlExecutor 插入无法将自增id回写实体的bug，暂时只支持 Integer 类型回写
• 修复：后端请求体响应体太长导致日志无法保存的问题，现在最多能保存1000长度的请求体响应体内容

升级

• 升级：重要 Nodejs 升级至 24

文档

• 更新：更新数据权限文档说明
• 升级：前端相关依赖升级至最新版本

v1.6.0 (2025-09-08)

新特性

• 新增：菜单搜索功能，现在可以按照菜单名称模糊搜索菜单。
• 新增：Form 表单 组件新增 $param，当组件的属性名和列定义的属性名冲突时，使用 $param 属性解决冲突
• 新增：Form 表单 组件新增支持 el-tree-select、el-color-picker-panel、el-date-picker-panel、el-input-tag、 el-mention 表单组件
• 新增：Table 表格 组件添加属性 sortable 来控制所有列是否默认可排序
• 新增：Table 表格 新增用户可动态设置列固定功能

优化

• 修复：代码生成器继承 BaseEntity 错误的问题
• 修复：Table 表格 组件，slotName 无法自定义简单查询表单插槽的问题
• 优化：后端去除默认的视频抽帧逻辑，移除 opencv 依赖，大部分用户用不上，并且会导致打包体积过大，增加部署负担
• 优化：添加详细的后端 BaseJdbcDao 方法注释，更易于开发使用

升级 （保持依赖库的更新是生产的最佳实践）

• 升级：重要 typescript 升级至最新 5.9.2 版本
• 升级：重要 EChart 图表 升级至 6.x 版本
• 升级：前端相关依赖升级至最新版本
• 升级：后端依赖升级，SpringBoot 升级至 3.5.5 版本

文档

• 新增：后端手册：使用数据库、配置数据源、后端规范等
• 修复：文档的部分错误信息

v1.5.0 (2025-06-26)

新特性

• 新增：新增菜单栏主题反转功能
• 新增：新增灵动风格页签，优化菜单和页签的样式
• 新增：ExcelImport 导入 组件新增嵌入式导入

优化

• 修复：矮屏设备下表格滚动异常的问题
• 修复：Table 表格 组件 row-dblclick 事件无法传递的bug
• 修复：Validate 数据验证 工具类在验证最大值 max 时，默认的错误信息不对的问题
• 优化：系统日志明细页面的 json 数据现在会格式化展示，方便阅读
• 优化：TopFilter 功能优化，按钮栏始终固定在第一行最后一栏
• 优化：OperationButton 按钮收纳组件性能优化
• 优化：Form 表单 组件跨列问题修复
• 优化：nprogress 体验优化
• 优化：添加面包屑切换动画
• 优化：部分页面样式细节优化
• 优化：部分中文国际化翻译内容优化
• 修复：后端代码生成器的部分bug，优化代码
• 优化：后端对未登录异常信息进行细分提示
• 优化：后端登录逻辑代码优化
• 优化：后端 common-log 模块已删除
• 优化：后端配置文件部分配置
• 优化：新增系统公用 banner

升级 （保持依赖库的更新是生产的最佳实践）

• 升级：重要 vite 升级至 7.x 版本
• 升级：重要 Nacos 升级至 3.0.x
• 升级：重要 中间件 Jenkins 升级至 jdk25-lts
• 升级：重要 中间件 xxl-job 升级至 3.1.0
• 升级：前端相关依赖升级至最新版本
• 升级：后端依赖升级，部分代码兼容性调整

文档

• 新增：文档布局调整
• 新增：数据权限文档，帮助新同学更快理解数据权限实现，赶快去学习吧~
• 新增：ExcelImport 导入 组件新增嵌入式导入说明和案例
• 调整：Nacos 已升级至 3.0.x，中间件部署版本及初始化sql已更新
• 调整：xxl-job 升级至 3.1.0，中间件部署版本已更新及初始化sql已更新
• 修复：文档的部分错误信息，错别字等

测试

• 测试：后端公共数据权限sql测试用例

v1.4.0 (2025-04-13)

新特性

• 新增：用户角色支持排序并可设置默认角色
• 新增：代码生成器支持自动创建系统菜单、支持自动创建系统数据实体并启用数据权限
• 新增：用户管理新增密码重置功能

优化

• 修复：修复 Upload 上传 single 属性为 true 时，附件上传异常的问题
• 优化：后端业务异常会打印输出异常抛出位置，方便定位
• 优化：部分页面样式细节优化

升级

• 升级：前端依赖升级至最新版本
• 升级：Springboot升级至 3.4.3，SaToken升级至 1.41.0

文档

• 修复：README文档的部分错误信息
• 修复：init_xh_admin.sql 初始化数据库sql有部分错误导致数据库无法初始化的问题

v1.3.0 (2025-02-09)

新特性

• 新增：后端新增 common-nacos 模块，这样是考虑到部分用户仅需要使用本地配置文件来启动一个单体架构的服务，无需部署 nacos 作为配置中心和注册中心， 请参考 以单体架构运行后端服务 章节查看详情

优化

• 修复：Table 表格 组件下载excel数据时，如果高级筛选有无效的条件，会导致导出报错的问题
• 修复：Form 表单 组件在提交时，若表单中存在文件上传并且设置single属性为单一文件上传，同时也设置该表单项必填则无法提交表单的问题
• 修复：代码生成列表删除会报错的问题
• 修复：若用户账号未分配角色在登录时报错的问题
• 优化：重要 现在后端的 file 文件服务已被删除，其功能已合并至 system 系统服务
• 优化：ExcelImport 导入 组件错误信息优化
• 优化：部分页面样式细节优化
• 优化：在线用户查询默认按照登录时间降序查询

升级

• 升级：前端依赖均已升级至最新版本
• 升级：SpringBoot 版本至 v3.4.1

文档

• 因为删除了 file 服务，所以后端安装文档，nacos 初始化文件配置均已更新

v1.2.1 (2024-12-15)

新特性

• 新增：现在 BaseJdbcDao 中实现的耦合数据库操作已经抽离为 SqlExecutor 接口，实现此接口来支持不同数据库类型的ORM持久化操作
• 新增：MysqlExecutor 实现类来支持 mysql 数据库的持久化操作
• 新增：PostgreSqlExecutor 实现类来支持 postgres 数据库的持久化操作

优化

• 修复：因为全局自定义序列化规则导致后端生成的 swagger文档 无法访问的问题
• 修复：Dict 获取数据字典详情 重复获取相同数据字典类型明细时缓存失效的问题
• 修复：Table 表格 组件 列设置 在序号列隐藏后样式错乱的问题
• 优化：因为 postgresql 对类型比较敏感，所以现在 Controller 层的id参数修已经调整为实体id的实际类型来接收
• 优化：优化在小屏设备的滚动条用户体验，小屏设备使用更流畅
• 优化：代码生成 在代码下载的zip文件名称默认为 功能名.zip，代码生成明细查看时隐藏清空和排序按钮
• 优化：代码生成 输入表名称会自动按规则带出实体名
• 优化：一些菜单按钮添加了图标，现在的界面更加美观

升级

• 升级：vite 已升级至最新的 6.x 版本，移除 vite5 的 sass 现代化配置，因为在 vite6.x 版本中已默认使用现代的API来编译 sass

文档

• 新增：Swagger 文档
• 优化：文档现在会显示当前系统的版本号，优化了部分文档错误

v1.2.0 (2024-11-24)

新特性

• 新增：重要 新增 代码生成 功能菜单，现在可以在开发环境生成规范的增删改查代码了， 系统初始化sql语句、 jenkins部署脚本 都已更新
• 新增：重要 后端新增 generator 微服务
• 新增：Table 表格 操作按钮列新增 hidden 属性，可以手动控制显隐
• 新增：Table 表格 按钮的 icon 属性支持直接传入 Icon 图标 组件的 value 展示自定义图标
• 新增：Table 表格 组件现在支持 el-table-row 默认插槽，默认追加到配置项列后边
• 新增：Validate 数据验证 增加了整数 int 的快捷验证类型
• 新增：Validate 数据验证 现在整体的表单数据验证函数支持直接传入规则数组来进行验证
• 新增：utils 工具类新增一些字符串处理函数，方便一些字符串的处理

优化

• 修复：修复 el-dialog 和 el-drawer 在全屏时的宽度无法充满的问题
• 修复：修复 typescript 类型定义的部分错误
• 修复：修复 Table 表格 组件的内存泄漏问题（该漏洞导致切换页签内存无法释放，编辑型表格内持续编辑会占用大量内存）
• 修复：修复 Upload 上传 single 属性为 true 时，附件在预览时无法下载的问题
• 修复：修复 Request 请求 在响应内容类型为非 application/json 时无法正确处理的问题，现在服务端响应文件流也可以正确处理
• 优化：现在 Table 表格 组件的表格列被用户调整排序后，导出的excel文件列将会保持与排序后的表格列一致
• 优化：Form 表单 组件表单项动态布局的实现逻辑，现在实现跨列布局也更加容易、灵活

升级

• 升级：eslint 升级至9.x版本，现在eslint配置文件已调整至新版本格式
• 升级：前端和后端所有依赖均已升级至最新版本

文档

• 新增：Form 表单 手册新增一些演示案例
• 新增：新增 初始化语句 文档，方便新人安装时找到初始化语句
• 优化：修复部分文档错误

v1.1.1 (2024-08-25)

新特性

• 新增：数据权限 功能， 简单，灵活，强大的的数据权限设计方案，由 人员ID、机构ID、角色ID 三个条件自由组合的逻辑表达式动态生成权限sql，可轻松实现各种场景的数据权限需求。
• 新增：现在 文件管理、系统日志 功能列表数据已经添加数据权限逻辑，可在 角色管理 菜单中动态设置其数据权限。
• 新增：全局单例的上下文菜单显示工具类函数，轻松实现右击显示菜单功能， 参考前端手册 ContextMenu 上下文菜单。
• 新增：现在系统请求如果发生错误，那么本次请求始终会记录到系统日志中，方便后续问题排查。
• 新增：数据权限基础实体，保存时，会自动注入当前岗位机构id和权限id，当有数据权限需求时，可继承该类实现默认逻辑。
• 新增：LoginUtil 类新增 getOnlineUserInfo 方法方便获取当前登录用户详情。

优化

• 修复：系统菜单 维护功能选择上级菜单后，无法保存的bug
• 修复：EChart 图表 初次渲染动画丢失的问题
• 优化：EChart 图表 工具函数，如果图表初始化时，dom实例隐藏或者宽高为0，那么表格渲会染延迟到dom显示之后
• 优化：系统日志 查询样式优化调整，列顺序调整
• 优化：TopFilter 组件，放弃原有表单实现逻辑，现使用 Form 表单 组件来实现简单查询条件表单

文档

• 新增：前端手册 - ContextMenu 上下文菜单 工具类手册

v1.1.0 (2024-08-03)

新特性

• 新增：Table 组件添加 validate 暴露方法，可进行表格编辑数据的表单验证，支持内存分页状态下的表单验证
• 新增：系统菜单查询添加创建时间区间查询

优化

• 修复：SvgIcon 组件 src 切换源码加载顺序错误，导致图标显示不对的问题，svg 属性动态修改的bug
• 修复：IconSelect 组件 选择本地svg图标时样式问题
• 修复：SingleDatePicker 组件起止日期不能选择相同日期的问题
• 修复：圆润页签图标不显示的问题
• 优化：ExcelImport 组件调整 on-complete 函数为 Promise 异步返回
• 优化：Form 组件表单项 render 添加默认的渲染的 vNode 参数

文档

• 新增：前端手册 - Table 组件手册
• 新增：前端手册 - Form 组件手册
• 新增：前端手册 - 前端规范说明文档
• 调整：nacos初始化sql调整，演示文档模拟后台地址调整

v1.0.2 (2024-07-20)

新特性

• 新增：文件下载预览支持304协商缓存

优化

• 优化：ExcelImport 组件调整 on-complete 函数为 Promise 异步返回
• 优化：部分类型定义注释更新
• 升级：更新依赖库版本至最新

文档

• 新增：前端手册 - Upload 组件手册
• 新增：前端手册 - Icon 组件手册
• 新增：前端手册 - ExcelImport 组件手册
• 新增：前端手册 - validate 工具类手册

v1.0.1 (2024-06-17)

新特性

• 新增：布局配置栏可定制菜单宽度

优化

• 优化：布局bug导致的ui卡顿问题
• 优化：矮屏设备不展示 navTabs 页签栏
• 修复：当请求体未被 controller 读取，ContentCachingRequestWrapper 读取请求体内容为空的问题，导致日志未记录请求体内容
• 修复：当 ip 地址为 localhost 时不解析 ip所属地

文档

• 调整：README文件调整
• 调整：底部栏调整

v1.0.0 (2024-06-01)

新特性

• 新增：系统管理模块
• 新增：菜单管理
• 新增：用户管理
• 新增：角色管理
• 新增：机构管理
• 新增：用户组管理
• 新增：文件管理
• 新增：数据字典
• 新增：系统日志

文档

• 新增：项目文档