开发指南
更新日志

【v2026-06】

# 计划搞 IM！！！

# 🚀 新增功能

移动端专区：

【升级】Wot UI 升级到 2.x，并同步更新文档链接与表单 schema 适配，由 @芋道源码 (opens new window) 贡献 #46 (opens new window)、30fe4eb (opens new window)
【新增】支持 form-create 使用 Wot UI 渲染，补齐移动端 API、事件、联动、子表单、流程表单、小程序渲染等兼容能力，由 @芋道源码 (opens new window) 贡献 #47 (opens new window)、7875a47 (opens new window)
【新增】移动端新增芋道增强组件目录与 yd-tree-select 树选择组件，支持部门、菜单单选树以及租户套餐菜单权限多选，提交时同步保留半选父节点，并清理旧版 system-select/tree-select 与 wot-ui-plus 兼容组件，由 @芋道源码 (opens new window) 贡献 82397d90 (opens new window)，对应 https://t.zsxq.com/bpkwM (opens new window)
【优化】移动端管理列表统一迁移为 z-paging 分页，支持返回列表自动刷新、顶部下拉刷新、底部自动加载更多、空状态和错误重试，并同步更新代码生成器模板与快照单测，由 @芋道源码 (opens new window) 贡献 11dd407e18 (opens new window)
【优化】移动端对齐 unibest 至 2026-05 版本，补齐构建配置、Token 刷新、TabBar 同步、角色动态 TabBar、抖音小程序开发者工具、微信小程序 CI 上传等上游能力，由 @芋道源码 (opens new window) 贡献 90ad5837 (opens new window)、43e8e4f0 (opens new window)、485c846b (opens new window)、1fdfcfa3 (opens new window)、880d31f4 (opens new window)、a77bc59d (opens new window)、26f27210 (opens new window)、d1ad1fbc (opens new window)

商城专区：

【新增】商城 uniapp 支持 H5 公众号微信商家转账确认收款，补齐 requestMerchantTransfer JSAPI 调起与 openid 兜底获取，并在支付手册补充 JSSDK 权限开启说明，由 @芋道源码 (opens new window) 贡献 84a9fb5c7 (opens new window)

Vben5.0 管理后台专区：

【新增】Ant Design Vue Next 版本同步 MES、WMS、IoT 模块，并与 Ant Design Vue 版本对齐页面、路由和业务能力，由 @XuZhiqiang (opens new window) 贡献 #357 (opens new window)、da85dcf87 (opens new window)

Vue2 管理后台专区：

【新增】Vue2 管理后台将旧版 Form Generator 替换为 form-create 表单设计器，支持与 Vue3 表单 schema 互通，并补齐用户选择、部门选择、字典选择、地区选择、接口选择、iframe、图片上传、文件上传、富文本等增强组件，由 @芋道源码 (opens new window) 贡献 8a97b97 (opens new window)、9d1ffc2 (opens new window)
【新增】Vue2 管理后台 BPM 工作流整体对齐 Vue3 + Element Plus 版本，迁移流程模型、流程定义、流程实例、待办/已办/抄送/管理任务、流程报表、流程详情、流程发起、审批操作、简单流程设计器和业务表单打印等能力，并补充功能审计、视觉对比和构建校验，由 @芋道源码 (opens new window) 贡献 1e1ad61 (opens new window)、6e5ae4b (opens new window)

Vue3 管理后台专区：

【新增】定时任务列表增加同步任务按钮，支持手动同步任务到 Quartz 调度器，并同步适配 Vben5.0 管理后台 Ant Design Vue、Element Plus、Ant Design Vue Next 三端，由 @HmEJ (opens new window) 贡献 #229 (opens new window)

BPM 工作流专区：

【新增】流程打印支持渲染业务表单，未启用自定义打印模板且流程表单字段为空时，可通过业务表单查看路径动态加载详情组件，并同步适配 Vue3、Vben5.0 管理后台 Ant Design Vue 与 Element Plus 版本，由 @芋道源码 (opens new window) 贡献 394a3d07 (opens new window)、f89b0365a (opens new window)，对应 https://t.zsxq.com/Yh8sC (opens new window)
【新增】BPM 审批通过、审批拒绝支持上传附件，并在审批详情时间线中展示任务附件；同步适配 Vue3 管理后台、Vben5.0 管理后台 Ant Design Vue / Ant Design Vue Next / Element Plus 三端，以及移动端 BPM 审批详情附件回显，由 @jason (opens new window) 贡献后端 #1556 (opens new window)、前端 #360 (opens new window)

IoT 物联网专区：

【新增】IoT 网关支持 Kafka 消息总线实现，新增 type: kafka 自动配置与网关 Kafka 连接配置，默认仍使用 Redis，可按需切换 Kafka 通信，由 @芋道源码 (opens new window) 贡献

后端框架专区：

【新增】支持瀚高 HighGo 数据库，按 PostgreSQL 兼容模式新增 sql/highgo 脚本、Docker 启动示例、SQL 转换器参数和本地数据源配置示例，并同步后端 PostgreSQL 驱动依赖，方便直接切换瀚高连接测试，由 @芋道源码 (opens new window) 贡献，对应 https://t.zsxq.com/a0rhg (opens new window)

# 🐞 问题修复

移动端专区：

【优化】BPM 模块整体代码质量，统一移动端流程表单、任务、流程实例等页面实现细节，由 @芋道源码 (opens new window) 贡献 #48 (opens new window)

BPM 工作流专区：

【修复】Flowable 升级到 8.0.0，修复并行分支回退到并行节点前时流程状态迁移异常的问题，由 @Jason (opens new window) 贡献 #1556 (opens new window)

Vue2 管理后台专区：

【修复】Vue2 管理后台兼容 Vue3/Iconify 风格图标配置，支持菜单和页面中的 ep:* 图标在原 svg-icon 组件中正常渲染，避免从数据库读取菜单后出现图标空白的问题，由 @芋道源码 (opens new window) 修复 c20e695 (opens new window)

Vue3 管理后台专区：

【增强】Vue3 管理后台布局、菜单和路由能力对齐 Vben 5，支持垂直、双列菜单、水平、侧边导航、混合垂直、混合双列 6 种布局；菜单支持顶部根菜单、侧边子菜单、水平菜单溢出更多、外链 iframe、query/hash/params 和动态路径参数，并补充布局路由交互自测，由 @芋道源码 (opens new window) 贡献
【修复】升级 Element Plus 后，搜索栏 ContentWrap 因 el-card body 默认 overflow: auto 出现多余滚动条的问题，由 @芋道源码 (opens new window) 修复 #IJQYL9 (opens new window)

商城专区：

【修复】商城首页的运营数据「账户充值」金额直接按分展示，未转换为元的问题，由 @芋道源码 (opens new window) 贡献 0e46f097 (opens new window)、f8fb3d881 (opens new window)，对应 https://t.zsxq.com/Grj5o (opens new window)
【修复】商城移动端客服新会话消息超出可视区域，导致首条消息需要下拉后才能看到的问题，由 @芋道源码 (opens new window) 修复 9ede13e82 (opens new window)，对应 https://t.zsxq.com/H929J (opens new window)
【修复】商城移动端申请售后时未选择售后类型仍可提交，导致后端空指针异常的问题，前后端均增加售后类型必填校验，由 @芋道源码 (opens new window) 修复 eb767f77e3 (opens new window)、833832178 (opens new window)，对应 https://t.zsxq.com/N2EAU (opens new window)
【修复】Vben5.0 管理后台商城文章列表新增/修改文章弹窗无响应，以及打开商品选择弹窗时关闭文章弹窗的问题；同步修正 Ant Design Vue、Element Plus、Ant Design Vue Next 三端新增默认值，由 @芋道源码 (opens new window) 修复 8ed97335 (opens new window)，对应 https://t.zsxq.com/8Ragy (opens new window)
【修复】Vben5.0 管理后台商城模块在 Ant Design Vue、Element Plus、Ant Design Vue Next 三端的类型校验和组件兼容问题，包括商城统计时间参数、装修组件样式配置、组合/积分活动选择、客服消息类型导入、运费模板树形选择等，由 @芋道源码 (opens new window) 修复，对应 https://t.zsxq.com/ta9ZT (opens new window)
【修复】Vue3 管理后台商城装修菜单在父子路由名称相同时，同名子菜单「装修模板」不显示的问题，由 @芋道源码 (opens new window) 贡献 9bcffb8b3 (opens new window)，对应 https://t.zsxq.com/HlDgT (opens new window)、https://t.zsxq.com/zghus (opens new window)

MES 制造执行专区：

【修复】Vue3 管理后台排班管理的节假日设置页面移除冗余 dayjs-plugin-lunar 依赖，统一使用 tyme4ts 计算农历、节日和节气信息，由 @芋道源码 (opens new window) 贡献 a4f876041 (opens new window)，对应 https://t.zsxq.com/hxPyG (opens new window)
【修复】MES 主数据自动编码生成时，因 Redis 流水号落后于历史数据导致编码重复而生成失败的问题，改为重复时自动重试（最多 10 次）跳过已存在编码，由 @芋道源码 (opens new window) 修复 633bd70dfe (opens new window)，对应 https://t.zsxq.com/WAv8D (opens new window)
【修复】Vben5.0 管理后台 MES 模块在 Ant Design Vue、Element Plus、Ant Design Vue Next 三端的生产工单、外协工单、到货通知单、发货通知单、工作站等选择弹窗问题，修复单选场景展示多选框、固定 status / type 筛选丢失和空值误展示清空图标的问题，由 @芋道源码 (opens new window) 修复，对应 https://t.zsxq.com/dtLd8 (opens new window)
【修复】MES SN 码明细查看条码时缺少 bizType 导致后端报错的问题，补齐 SN 码条码业务类型、条码配置和前端条码入口，并适配 Vue3 管理后台与 Vben5.0 管理后台 Ant Design Vue、Element Plus 版本，由 @芋道源码 (opens new window) 修复，对应 https://t.zsxq.com/1YCqD (opens new window)

WMS 仓储管理专区：

【修复】WMS 完成入库时多条库存记录批量锁定顺序不稳定的问题，按库存编号排序后再执行 FOR UPDATE 锁定，并补充多库存明细变更单元测试，由 @芋道源码 (opens new window) 修复，对应 https://t.zsxq.com/KkubL (opens new window)

Vben5.0 管理后台专区：

【修复】CRM 回款管理、回款计划：修复新增回款弹窗打开后，客户、合同、回款期数、金额等预填数据被依赖刷新清空的问题，由 @芋道源码 (opens new window) 贡献 9d2446b6f (opens new window)，对应 https://wx.zsxq.com/group/88858522214142/topic/14422454252254212 (opens new window)
【修复】ERP 付款单、收款单、采购入库、采购退货、销售出库、销售退货的关联单据选择弹窗表格过窄、表格高度被压缩，以及操作子弹窗误关闭主弹窗的问题，由 @芋道源码 (opens new window) 贡献 651a52518 (opens new window)，对应 https://t.zsxq.com/04iiW (opens new window)
【修复】WMS 模块在 Ant Design Vue、Element Plus、Ant Design Vue Next 三端的商品分类、往来企业、首页单据统计等页面导入错误问题，由 @芋道源码 (opens new window) 修复 #IJSDL9 (opens new window)，对应 https://t.zsxq.com/EGvsS (opens new window)
【修复】Vben5.0 管理后台会员、CRM、商城交易等表单的地区选择器只展示末级地区、无法按省市区级联选择的问题，新增三端通用地区级联选择组件，支持完整路径回显并保持表单值为末级地区编号，由 @芋道源码 (opens new window) 修复 fb80749 (opens new window)，对应 https://t.zsxq.com/Kf8YM (opens new window)

支付系统专区：

【修复】微信转账确认收款的 channelPackageInfo 在同步任务先更新为转账中时丢失的问题，支持发起转账响应后续补写 package 信息，由 @芋道源码 (opens new window) 修复 #1144 (opens new window)

IoT 物联网专区：

【修复】使用 Redis 消息队列时 iot_device_message Stream 消息无限积压的问题，区分业务 MQ 与 IoT Redis 总线的重发、清理任务分布式锁，由 @熊猫大侠 (opens new window) 贡献 #1544 (opens new window)、858a351c94 (opens new window)
【修复】TDengine WebSocket 示例连接增加 enableAutoReconnect=true 自动重连参数，避免长连接断开后写入报 Websocket Not Connected Exception for connection closed，由 @芋道源码 (opens new window) 修复，对应 https://t.zsxq.com/qaX9c (opens new window)
【修复】场景联动规则列表最近触发时间一直显示未触发的问题，后端返回最后触发时间并修正 Vue3 管理后台字段读取，由 @熊猫大侠 (opens new window) 贡献后端 #1543 (opens new window)、前端 #882 (opens new window)、ef5a3ae7 (opens new window)、69cd0b7 (opens new window)
【优化】Modbus TCP Client 轮询支持按功能码、轮询间隔和连续地址聚合批量读取点位，减少连续寄存器逐点读取的请求次数，由 @芋道源码 (opens new window) 修复，对应 #1147 (opens new window)、c1101dc4b9 (opens new window)

后端框架专区：

【修复】基础设施：文件 URL 路径包含中文、空格、%、+ 等特殊字符时访问或下载异常的问题，统一 URL Path 编解码、S3 预签名 URL 与 Content-Disposition 文件名处理，并补充单元测试，由 @芋道源码 (opens new window) 修复，对应 #1149 (opens new window)、#1545 (opens new window)
【修复】基础设施：代码生成兼容 Windows 换行，修复 Codegen 快照单测在 CRLF 环境下失败的问题，由 @haohaoMT (opens new window) 贡献 #1551 (opens new window)、574f90d (opens new window)
【修复】多租户 Job 切面按需注册，未引入 xxl-job-core / yudao-spring-boot-starter-job 的模块启动时不再因 TenantJobAspect 加载 XxlJobContext 报 NoClassDefFoundError，由 @芋道源码 (opens new window) 修复，对应 #IJTOFS (opens new window)
【修复】多租户 MQ 配置按需注册，未引入 yudao-spring-boot-starter-mq 的模块启动时不再因解析 YudaoTenantAutoConfiguration 方法签名加载 RedisMessageInterceptor 报 NoClassDefFoundError，由 @芋道源码 (opens new window) 修复，对应 #IJTOF4 (opens new window)

← 运行发布【v2026-05】→