开发指南
更新日志

【v2026-08】

# 新增 HRM 人力资源管理系统、FMS 财务管理系统，支持独立手机端操作

本月概要：

【HRM】完成人力资源管理模块整合，补齐对应的后端工程与业务能力，并支持 Admin 移动端。
【FMS】完成财务管理模块整合，补齐对应的后端工程与业务能力，并支持 Admin 移动端。
【稳定性】修复工作流、Vben5.0、支付及基础设施等模块的用户反馈问题，增强系统稳定性。

# 📈 Statistic

总代码行数：552658
源码代码行数：353795
注释行数：118243
单元测试用例数：3299

# 🚀 新增功能

后端框架专区：

【优化】扩展 LambdaQueryWrapperX 的 exists、notExists、and、or、nested、not 链式查询方法，保持自定义 Wrapper 类型返回，由 @wuKongD (opens new window) 贡献 #265 (opens new window)

HRM 人力资源专区：

【新增】HRM 人力资源管理系统，支持 admin 手机端，由 @芋道源码 (opens new window) 贡献 e2fa61b7 (opens new window)

FMS 财务管理专区：

【新增】FMS 财务管理系统，支持 admin 手机端，，由 @芋道源码 (opens new window) 贡献 0628a46b (opens new window)

支付模块专区：

【新增】支付宝小程序支付，支持 buyer_open_id、buyer_id 和证书模式下单，并补充对应单元测试，由 @graypxl (opens new window) 贡献 #1194 (opens new window)

IoT 物联网专区：

【新增】补齐 OTA 固件列表删除功能，存在进行中的升级任务时禁止删除固件，由 @pandadx (opens new window) 贡献 !1579 (opens new window)

Vue2 管理后台专区：

【优化】Vue2 管理后台 BPM 工作流整体对齐 Vue3 + Element Plus 版本，由 @芋道源码 (opens new window) 贡献 e4d0a26 (opens new window)，对应 <https://t.zsxq.com/7BSE6 >

Vue3 管理后台专区：

【优化】优化代码生成界面预览代码对话框布局，减少不必要的内边距并避免右侧代码区域超出视口，由 @fc88804 (opens new window) 贡献 !903 (opens new window)

# 🐞 问题修复

后端框架专区：

【修复】修复阿里云 OSS、七牛云使用自定义域名时前端直传签名地址生成错误的问题，签名节点改用服务商 endpoint，并补充对应单元测试，由 @situjunjie (opens new window) 贡献 !1588 (opens new window)，对应 https://t.zsxq.com/qYxXZ (opens new window)
【修复】邮件模板 HTML 代码块内容包含 $ 或反斜杠时，MailTemplateServiceImpl 使用正则替换可能抛出 IllegalArgumentException 的问题，通过 Matcher.quoteReplacement 安全处理替换内容，由 @nemisolv (opens new window) 贡献 #1204 (opens new window)
【修复】WebProperties 嵌套配置属性未正确进行级联校验的问题，为 appApi、adminApi、adminUi 增加 @Valid 校验，由 @nemisolv (opens new window) 贡献 #1187 (opens new window)
【修复】单体版、微服务版 GlobalExceptionHandler 处理携带成功码（code = 0）的 ServiceException 时，避免继续调用 CommonResult.error 抛出异常，统一返回系统异常，由 @芋道源码 (opens new window) 修复单体版 d7411081 (opens new window)、微服务版 4658bca2 (opens new window)，对应 #1196 (opens new window)
【修复】单体版、微服务版在多 SecurityFilterChain 场景下，TokenAuthenticationFilter 被 Spring Boot 注册为 Servlet 全局过滤器，导致独立安全链请求被越界处理的问题；通过禁用 FilterRegistrationBean 自动注册，确保过滤器仅由 Spring Security FilterChain 管理，由 @芋道源码 (opens new window) 修复单体版 809d6aaa (opens new window)、微服务版 1731933a (opens new window)，对应 #1198 (opens new window)
【修复】修复 BPM 流程发起人部门负责人获取错误的问题，优先使用流程变量中的发起人编号查询部门，避免错误使用当前登录用户，由 @周洋洋 (opens new window) 贡献 922c8b83 (opens new window)，对应 IK8441 (opens new window)

支付模块专区：

【修复】修复微信支付使用临时证书文件时，系统清理临时文件导致支付不定时不可用的问题，改用微信支付 SDK 的证书内容配置，由 @IDontDrive (opens new window) 贡献 #263 (opens new window)
【修复】修复支付宝支付回调中渠道用户 ID 获取错误的问题，优先使用 buyer_open_id，兼容 buyer_id，并更新渠道用户编号说明，由 @wuKongD (opens new window) 贡献 #266 (opens new window)

MES 制造执行专区：

【修复】修复排班计划倒班字段联动清理及排班生成异常：单白班不倒班，非按天倒班清理倒班天数，并校验倒班参数，由 @hnnuWangli (opens new window) 贡献 !1583 (opens new window)

IoT 物联网专区：

【修复】IoT 设备消息发送接口权限标识错误，将 Controller 的 iot:device:message-end 统一为菜单 SQL 的 iot:device:message-send，由 @芋道源码 (opens new window) 修复 8569533 (opens new window)，对应 https://t.zsxq.com/9eFK5 (opens new window)

Vben5.0 管理后台专区：

【修复】Vben5.0 管理后台 web-antd、web-antdv-next、web-ele 流程图查看器初始化时序问题，由 @周洋洋 (opens new window) 贡献 !898 (opens new window)，同步修复提交 1573e9ce3 (opens new window)
【修复】Vben5.0 管理后台 BPM 流程发起页流程卡片空白，以及三端流程搜索、分类分组和表单变量清理不一致的问题，由 @芋道源码 (opens new window) 修复 a66bfc1d (opens new window)，对应 https://t.zsxq.com/PR6Zd (opens new window)
【修复】Vben5.0 管理后台 web-ele AI 聊天角色知识库、工具和 MCP 选择器无法多选的问题，由 @芋道源码 (opens new window) 修复 7810113a (opens new window)，对应 https://t.zsxq.com/EVBwh (opens new window)
【修复】Vue3、Vben5.0 管理后台 HRM 考勤班次与每日明细查询的时间参数补齐时分秒，避免后端 LocalDateTime 解析失败，由 @芋道源码 (opens new window) 修复 Vue3 cb46b231 (opens new window)、Vben5.0 816c71b28 (opens new window)，对应 https://t.zsxq.com/aSB5X (opens new window)
【修复】Vben5.0 管理后台 Ant Design Vue、Element Plus、Ant Design Vue Next、Naive UI、TDesign 五端的 S3 文件配置 PathStyle 字段命名与后端不一致的问题，统一使用 enablePathStyleAccess，确保配置字段契约一致，由 @芋道源码 (opens new window) 修复 ff2050e90 (opens new window)，对应 https://t.zsxq.com/H4WtU (opens new window)
【修复】Vben5.0 管理后台 web-antd、web-antdv-next、web-ele 的 IoT 数据规则数据源弹窗取消后再次打开可能报错的问题，改用 VXE 实际行对象绑定并移除关闭阶段异步清空，由 @芋道源码 (opens new window) 修复 8342ff2 (opens new window)，对应 https://t.zsxq.com/9eFK5 (opens new window)
【修复】Vben5.0 管理后台 BPM 流程监听表单编辑回填时事件、值被清空，以及 Ant Design Vue、Ant Design Vue Next 流程设计器更新名称、标识传递事件对象的问题，由 @etexxk (opens new window) 贡献 !385 (opens new window)，合并提交 7f45fb5 (opens new window)
【修复】Vben5.0 管理后台 web-antd、web-antdv-next、web-ele 公众号草稿封面与永久素材上传未携带正确公众号账号的问题，并阻止缺少封面的图文提交，由 @izhaong (opens new window) 贡献 #397 (opens new window)，合并提交 cb4cba3fe (opens new window)
【修复】Vben5.0 管理后台 web-ele MES 选择弹窗、子表弹窗及条码详情弹窗被父级 Modal 裁剪的问题，统一增加 append-to-body，由 @芋道源码 (opens new window) 修复 0c08089dd (opens new window)、4a671d086 (opens new window)，对应 https://t.zsxq.com/8xh0S (opens new window)

# 🔨 Dependency Upgrades

所有六套后端项目：

【升级】mybatis-plus from 3.5.16 to 3.5.17
【升级】mybatis-plus-join from 1.5.7 to 1.5.9
【升级】easy-trans 按 Spring Boot 版本升级为 SB2 2.3.6、SB3 3.1.8、SB4 4.0.2
【升级】redisson from 4.6.1 to 4.7.0
【升级】taos-jdbcdriver from 3.8.4 to 3.9.0
【升级】opentelemetry from 1.39.0 to 1.65.0
【升级】jedis-mock from 1.1.15 to 1.1.18
【升级】hutool-all from 5.8.46 to 5.8.47
【升级】aviator from 5.3.3 to 5.4.4
【升级】fastjson2 from 2.0.63 to 2.0.64
【升级】guava from 33.6.0-jre to 33.7.1-jre
【升级】jsch from 2.28.3 to 2.28.7
【升级】jsoup from 1.22.2 to 1.23.2
【升级】netty from 4.2.15.Final to 4.2.17.Final
【升级】AWS SDK S3 from 2.46.17 to 2.54.7
【升级】支付宝 SDK from 4.40.865.ALL to 4.40.978.ALL
【升级】微信 Java SDK from 4.8.4-20260623.211820 to 4.8.6-20260825.155844
【升级】JimuReport / JimuBI：SB3/SB4 from 2.3.4/2.3.2 to 2.5.1/2.5.0，SB2 保持 2.3.4/2.3.2

← 运行发布【v2026-07】→