开发指南
更新日志

【v2026-06】

# 新增 IM 即时通讯，正式发布 Spring Boot 4.X 支持单体、微服务两种

本月概要：

【IM 即时通讯】新增 IM 即时通讯，后端支持单体版、微服务版，前端覆盖 Vue3 与 Vben5.0 多端。
【Spring Boot 4】正式发布 Spring Boot 4.1.0 + JDK 25 支持，单体版、微服务版均新增 master-jdk25 分支。
【AI 大模型】升级接入 Spring AI 2.x，适配 OpenAI、Claude、DeepSeek、GLM、KIMI 等新版本客户端，并补齐 Grok、阶跃星辰等模型接入。
【Vue3 + Element Plus】优化构建、Lint、类型检查等执行速度，并支持多种菜单形态，日常开发反馈更快。
【Vben5.0】Ant Design Vue Next 版本正式完成，Ant Design Vue Next 与 Element Plus 两端已对齐 Vue3 + Element Plus 全部功能。
【Vue2 管理后台】补齐 BPM 工作流全部能力，方便老项目以及低版本浏览器要求的国产化项目继续使用。
【移动端】完整支持 BPM 审批（包括流程表单），并升级到 Wot UI 2.x，同步适配 form-create、z-paging 分页和多种工作台菜单风格等能力。

# 📈 Statistic

总代码行数：437233
源码代码行数：273977
注释行数：98082
单元测试用例数：2348

# 🚀 新增功能

IM 即时通讯专区：

【新增】新增 IM 即时通讯后端实现，单体版与微服务版均已支持，由 @芋道源码 (opens new window) 贡献
【新增】新增 IM 即时通讯前端实现，支持 Vue3 + Element Plus，以及 Vben5.0 管理后台 Ant Design Vue、Element Plus、Ant Design Vue Next 三端，由 @芋道源码 (opens new window) 贡献
【新增】新增 IM 即时通讯文档，支持查看单体版预览 (opens new window) 与微服务版预览 (opens new window)，由 @芋道源码 (opens new window) 贡献

AI 大模型专区：

【升级】AI 模块升级接入 Spring AI 2.x，适配 OpenAI、Claude、Gemini、DeepSeek、通义千问等新版本客户端和配置方式，并同步补齐 Grok、阶跃星辰等模型接入文档，由 @芋道源码 (opens new window) 贡献

移动端专区：

【升级】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)
【优化】移动端代码生成器表单模板对齐 Wot UI 2.x：普通字段统一用 wd-form-item 注册并将校验从 :rules 改为 :schema + createFormSchema，下拉字典改用 yd-form-picker、图片/文件上传改用 yd-upload-img / yd-upload-file、搜索日期范围抽取为 yd-search-date-range、日期时间字段改为触发框 + 弹层并按 LocalDateTime / LocalDate 分别用 formatDateTime / formatDate 回显；同时修正生成器误用的 wot-design-uni 引入为 @wot-ui/ui，并修复快照单测中同名 index.vue（列表/表单/详情）互相覆盖的问题，由 @芋道源码 (opens new window) 贡献 f6b5ef06d9 (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)
【新增】移动端工作台首页菜单重构：菜单数据抽成 menu.json 三层配置（分组 ▸ 二级分组 ▸ 菜单项），支持「小标题 / 折叠 / 纵向分类 / 横向分类」4 种可切换布局，并新增菜单搜索（按名称、模块、二级分组模糊匹配，点击直达）、我的常用（可增删与上下排序）、最近使用（点击自动记录）等能力；同时将菜单名、二级分组与展示顺序对齐 PC 管理后台 system_menu，并修复「仅 PC」提示页路径错误导致代码生成等仅 PC 菜单点击 404 的问题，由 @芋道源码 (opens new window) 贡献 c40aa44f (opens new window)

商城专区：

【新增】商城装修顶部导航栏支持“常驻显示 / 滚动显示”配置，移动端沉浸式导航栏可随页面滚动淡入，并同步适配 Vue3 管理后台、Vben5.0 管理后台 Ant Design Vue / Element Plus / Ant Design Vue Next 三端与商城 uniapp，由 @芋道源码 (opens new window) 贡献，对应 #IJW78X (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)

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)
【新增】项目配置新增 IM 即时通讯图标显示/隐藏开关，支持控制顶部聊天入口展示，并同步复制配置与中英文文案，由 @liguangni (opens new window) 贡献 #883 (opens new window)
【优化】Vue3 管理后台生产构建速度从三轮平均约 41.6s 降低到约 21.6s，使用 oxc 替换 terser，并将 ESLint、progress、auto d.ts、gzip/brotli、EJS、top-level-await 等构建链路对齐 Vben5.0 管理后台，由 @芋道源码 (opens new window) 贡献 3d37515c (opens new window)
【优化】Vue3 管理后台继续优化构建与 Lint 执行效率，关闭构建 gzip size 统计、移除未使用的 legacy/terser/ejs/eslint/progress 构建依赖，并为 ESLint、Stylelint、Prettier 增加缓存与 lint-staged 增量检查；其中 ESLint 热缓存耗时从约 16.3s 降低到约 1.3s，由 @芋道源码 (opens new window) 贡献 2ea2d9b18 (opens new window)
【优化】Vue3 管理后台为 pnpm ts:check 增加 TypeScript 增量缓存，缓存写入 node_modules/.cache/vue-tsc，实测热缓存耗时从约 46.5s 降低到约 15.3s，由 @芋道源码 (opens new window) 贡献 f4b2cc4 (opens new window)
【优化】Vue3 管理后台修复并统一 Lint 规则，明确 ESLint、Stylelint、Prettier 职责边界，排除 Tinyflow 生成产物并完成源码格式化，使 pnpm lint 可干净通过，由 @芋道源码 (opens new window) 贡献 3208a768 (opens new window)、18ed1cdf (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) 贡献

后端框架专区：

【升级】正式支持 Spring Boot 4.1.0 + JDK 25，单体版、微服务版均新增 master-jdk25 分支，并适配 Jackson 3、Spring Security 7、Spring Cloud 2025.1 等基础框架，由 @芋道源码 (opens new window)、@xingyu4j (opens new window) 贡献单体版 #1568 (opens new window)、微服务版 #256 (opens new window)
【新增】支持瀚高 HighGo 数据库，按 PostgreSQL 兼容模式新增 sql/highgo 脚本、Docker 启动示例、SQL 转换器参数和本地数据源配置示例，并同步后端 PostgreSQL 驱动依赖，方便直接切换瀚高连接测试，由 @芋道源码 (opens new window) 贡献，对应 https://t.zsxq.com/a0rhg (opens new window)

# 🐞 问题修复

CRM 客户管理专区：

【修复】跟进记录详情接口缺少关联业务对象读权限校验的问题，避免用户通过自增编号越权读取其他用户的跟进记录，由 c779a47661 (opens new window) 贡献，对应 #1159 (opens new window)

ERP 进销存专区：

【修复】销售订单接口权限标识误用 erp:sale-out:* 的问题，改为 erp:sale-order:*，避免仅拥有销售出库权限的用户越权访问销售订单，由 5d1fd70dc3 (opens new window) 贡献，对应 #1161 (opens new window)

移动端专区：

【修复】移动端 App 打包图标路径错误的问题，将 manifest.config.ts 中 Android / iOS 图标地址指向实际存在的 src/static/app/icons 目录，避免打包时找不到图标资源，由 @quitelinxd (opens new window) 贡献 #45 (opens new window)
【优化】BPM 模块整体代码质量，统一移动端流程表单、任务、流程实例等页面实现细节，由 @芋道源码 (opens new window) 贡献 #48 (opens new window)
【修复】移动端 BPM 审批详情中并行分支后的审批人自选问题，已有候选审批人时不再重复展示自选入口，并抽取通用空值判断工具，由 @Jason (opens new window) 贡献 #49 (opens new window)

MP 公众号专区：

【修复】公众号关注事件获取粉丝信息返回 48001 无接口权限时，错误码判断误用枚举实例导致兜底创建粉丝信息不生效的问题，由 @芋道源码 (opens new window) 修复 a25dd36be6 (opens new window)，对应 https://t.zsxq.com/xy7I6 (opens new window)

BPM 工作流专区：

【修复】Flowable 升级到 8.0.0，修复并行分支回退到并行节点前时流程状态迁移异常的问题，由 @Jason (opens new window) 贡献 #1556 (opens new window)
【修复】流程实例 BPMN 模型视图接口缺少权限校验的问题，补充 bpm:process-instance:query 权限，避免无权限用户访问流程表单、审批记录和 BPMN XML 等数据，由 @芋道源码 (opens new window) 修复，对应 #315 (opens new window)
【修复】BPM 审批人自选支持条件分支、并行分支后的下一个用户任务识别，并避免并行分支汇聚后重复覆盖已选择的审批人，由 @Jason (opens new window) 贡献 #1562 (opens new window)、d9b320f (opens new window)、57f575b (opens new window)
【修复】Vue3 管理后台 BPM 简单流程设计器导入、并行分支后的审批人自选，以及超时时间按天格式化的问题，由 @Jason (opens new window) 贡献 #885 (opens new window)
【修复】Vben5.0 管理后台 BPM 修复 OA 请假流程重新发起、审批按钮无响应、超时时间按天格式化、发起人节点审批意见展示等问题，由 @Jason (opens new window) 贡献 #354 (opens new window)
【修复】Vben5.0 管理后台 BPM 审批详情时间线显示异常的问题，去掉时间线内容 teleport，同步适配 Ant Design Vue、Element Plus、Ant Design Vue Next 三端，由 @Jason (opens new window) 贡献 #363 (opens new window)
【修复】Vben5.0 管理后台 BPM 简单流程设计器导入流程时节点数据初始化异常的问题，同步适配 Ant Design Vue、Element Plus、Ant Design Vue Next 三端，由 @Jason (opens new window) 贡献 #366 (opens new window)
【修复】Vben5.0 管理后台 BPM 审批人自选时下一个节点审批人显示异常，以及并行分支后的审批人自选问题，同步适配 Ant Design Vue、Element Plus、Ant Design Vue Next 三端，由 @Jason (opens new window) 贡献 #368 (opens new window)
【修复】BPM 审批通过时任务本地变量写入范围过大的问题，避免任务内嵌表单历史记录混入完整流程变量，由 @Jason (opens new window) 贡献后端 #1569 (opens new window)
【修复】BPM 审批详情首个发起人节点不再展示系统自动通过产生的审批意见，同步适配 Vue3 管理后台、Vben5.0 管理后台 Ant Design Vue / Element Plus / Ant Design Vue Next 三端和移动端，由 @Jason (opens new window) 贡献 Vue3 #887 (opens new window)、Vben5 #377 (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) 贡献
【修复】Vue3 管理后台移除 @intlify/unplugin-vue-i18n 插件，避免 Vite 8 / Rolldown 环境下 vue-i18n 走 esm-bundler 入口导致 init_runtime_dom_esm_bundler is not defined 报错，由 @DevDengChao (opens new window) 贡献 #231 (opens new window)，对应 #230 (opens new window)
【修复】Vue3 管理后台清理验证码滑块、站内信通知、商城客服会话列表组件卸载后的全局事件监听器和轮询定时器，避免页面切换后残留回调导致重复请求或内存泄漏，由 @gongdongxiang (opens new window) 贡献 #233 (opens new window)
【修复】升级 Element Plus 后，搜索栏 ContentWrap 因 el-card body 默认 overflow: auto 出现多余滚动条的问题，由 @芋道源码 (opens new window) 修复 #IJQYL9 (opens new window)
【修复】Vue3 管理后台批量收敛 TypeScript 类型问题，覆盖未使用代码清理、BPMN 设计器、CRM/ERP/MES/Mall 表单字段、支付详情弹窗加载态、预览交互、XButton/XTextButton 删除、ERP 订单/单据 items 类型、IOT 物模型与场景规则等场景，并为 Dialog 增加统一 loading 能力，使 pnpm ts:check 错误数从 1003 降低到 0，由 @芋道源码 (opens new window) 修复 63dfc5e (opens new window)、a57df0b (opens new window)、0970806 (opens new window)、e58fe91 (opens new window)、9c95beb (opens new window)、cb9400e (opens new window)、3f77909 (opens new window)、bc25430 (opens new window)、ba6ac7a (opens new window)、08abd54 (opens new window)、361f4d (opens new window)、983ac71 (opens new window)、6944499 (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 加锁查询携带 ORDER BY 时，租户拦截器重写 SQL 后生成 FOR UPDATE ORDER BY 导致 MySQL 语法错误的问题，改为去除 ID 排序，仅按 IN 条件锁定库存行，由 @芋道源码 (opens new window) 修复，对应 https://t.zsxq.com/gHhfb (opens new window)

Vben5.0 管理后台专区：

【优化】Vben5.0 管理后台优化 Lint 与 pre-commit 执行链路，将 unicorn / TypeScript 规则迁移到 oxlint 并完善 oxfmt 配置；同时支持按硬件资源自适应串行/并行执行、仅检查暂存文件并自动回填修复，避免低配机器提交时资源飙升，并修复 lefthook 中 workspace 局部依赖解析失败的问题，由 @xingyuv (opens new window) 贡献 dc3466d77 (opens new window)、dc3865f77 (opens new window)
【修复】Ant Design Vue Next 版本继续适配组件写法差异，统一 Form、Descriptions、Select、Radio、Menu、Checkbox、Timeline、DatePicker、Tabs、Button/Input 组合组件等用法，修复 MES、IoT、CRM、Mall 等页面迁移后的组件解析与类型兼容问题，由 @XuZhiqiang (opens new window) 贡献 #359 (opens new window)
【修复】Ant Design Vue Next 版本补齐 BPM 审批附件、审批意见和时间线展示能力，并修复日期时间回填、树选择筛选、代码生成预览、表格更多按钮对齐、表单校验、上传下载按钮等兼容问题，由 @XuZhiqiang (opens new window) 贡献 #364 (opens new window)
【修复】Vben5.0 管理后台修复阻塞 pre-commit 的类型检查问题，统一 ERP、MP、MES、Demo、BPM 流程监听弹窗等页面的类型兼容处理，并适配 Ant Design Vue Next 的 MES 组件类型约束，由 @XuZhiqiang (opens new window) 贡献 #365 (opens new window)
【修复】Vben5.0 管理后台修复弹窗内 Select 等下拉组件无法选中、偏好设置下拉框无法选择，以及鼠标悬停用户头像时下拉菜单反复隐藏/显示的问题，由 @xingyuv (opens new window) 贡献 c816591b6 (opens new window)、160114c5 (opens new window)
【修复】Vben5.0 管理后台收敛 Ant Design Vue、Element Plus、Ant Design Vue Next 三端的 IM、BPM、MES、WMS、商城等模块 Lint 与类型问题，覆盖 IM 会话/群组/RTC/消息组件、IM API 类型、BPM 流程设计器、MES/WMS 明细行、上传组件等场景，由 @xingyuv (opens new window) 贡献 58d4be589 (opens new window)、66c243239 (opens new window)、8c085552f (opens new window)、d9981568f (opens new window)、25be0950c (opens new window)、3d92c784c (opens new window)
【修复】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)
【修复】TDengine 设备属性字段名规范化不一致的问题，统一建表、写入和历史查询的物模型标识符为小写下划线格式，避免 PT、PA 等全大写缩写被误判为新增字段，由 @芋道源码 (opens new window) 修复 7e35f1dab9 (opens new window)，对应 https://t.zsxq.com/V2r9M (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)
【修复】基础设施：DM8 初始化 SQL 使用 varchar(n char) 保持与 MySQL 一致的字符长度语义，避免中文初始化数据因字节长度超限导入失败；同时补充 SET DEFINE OFF 与 PAGE_SIZE=16 等导入说明，由 @芋道源码 (opens new window) 修复，对应 #IJWWKK (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)

# 🔨 Dependency Upgrades

所有分支：

【升级】spring-boot from 3.5.14 to 3.5.15
【升级】spring-boot-admin from 3.5.8 to 3.5.9
【升级】netty from 4.2.14.Final to 4.2.15.Final
【升级】redisson from 4.4.0 to 4.6.1
【升级】taos-jdbcdriver from 3.8.3 to 3.8.4
【升级】rocketmq-spring-boot-starter from 2.3.5 to 2.3.6
【升级】hutool-all from 5.8.44 to 5.8.46
【升级】jsch from 2.28.2 to 2.28.3
【升级】awssdk from 2.44.0 to 2.46.17
【升级】alipay-sdk-java from 4.40.806.ALL to 4.40.865.ALL
【升级】weixin-java-* from 4.8.2 to 4.8.4，切换到 HttpClient 5
【升级】tika-core from 3.3.0 to 3.3.1
【升级】jedis-mock from 1.1.12 to 1.1.15
【升级】fastjson2 from 2.0.61 to 2.0.62
【迁移】easy-trans from com.fhs-opensource:3.0.6 to org.dromara:3.1.5

← 【v2026-07】【v2026-05】→