开发指南
更新日志

【v2025-08】

# 完善 vben5(antd) 工作流、迁移 vben5(ep) 商城、支持 IoT TCP 协议

# 📈 Statistic

总代码行数：260586
源码代码行数：161754
注释行数：59864
单元测试用例数：1121

# ⭐ New Features

【优化】默认禁用 easy-trans，避免影响接口性能，由 @芋道源码 (opens new window) 贡献 d650a0b (opens new window)
【优化】数据库连接池的配置，由 @芋道源码 (opens new window) 贡献 28965b9b (opens new window)
【优化】优化日志格式，解决 FILE 里存在 highlight、cyan高亮，由 @芋道源码 (opens new window) 贡献 529c570 (opens new window)
【优化】弱化对 skywalking 依赖，可按需引入，更灵活，由 @芋道源码 (opens new window) 贡献 529c570 (opens new window)
【优化】默认不引入 spring-boot-admin，更灵活，同时启动速度更快（提升开发效率），由 @芋道源码 (opens new window) 贡献 8e1729d (opens new window)
【新增】实现参数数据字典校验注解 @InDict，由 @java-acc (opens new window) 贡献 #852 (opens new window)
【优化】使用 fastExcel 替换 easyExcel，由 @xingyuv (opens new window) 贡献 #1362 (opens new window)
【优化】添加 Excel 导出时，自适应列宽处理器并替换默认列宽策略，由 @huangmingsir (opens new window) 贡献 #196 (opens new window)
【优化】sql/tools 错误信息输出到 stderr，由 @dhb52 (opens new window) 贡献 #1389 (opens new window)
【优化】vben5 代码生成路径的展示，由 @芋道源码 (opens new window) 贡献 ae9e35f (opens new window)

Vben5.0 + antd 管理后台专区：

【新增】ERP 首页适配已有组件，由 @陈賝 (opens new window) 贡献 #178 (opens new window)
【修复】修复 VbenTree 加载顺序问题，由 @简佳 (opens new window) 贡献 #177 (opens new window)
【新增】ERP 采购订单功能，由 @陈賝 (opens new window) 贡献 #181 (opens new window)

Vben5.0 + element-plus 管理后台专区：

【新增】MALL 商城相关的迁移，由 @痴货 (opens new window) 贡献 #179 (opens new window)

MALL 商城专区：

【优化】物流信息中增加电话号码高亮和点击功能，由 @macro (opens new window) 贡献 #154 (opens new window)
【新增】「店铺装修」导航栏中的搜索框添加功能和更多属性，由 @卢越 (opens new window) 贡献 #795 (opens new window)
【新增】「店铺装修」添加扫一扫图标和功能，由 @卢越 (opens new window) 贡献 #157 (opens new window)、#158 (opens new window)

BPM 工作流专区：

【新增】simple 设计器新增 userTask 跳过表达式，由 @Jason (opens new window) 贡献 1684706 (opens new window)、

Pay 支付专区：

【新增】增加 userid、usertype，并额外支持权限校验，由 @芋道源码 (opens new window) 贡献 8ffe927 (opens new window)、15aef8d (opens new window)

# 🐞 Bug Fixes

【修复】支持 yudao.websocket.enable 手动关闭，由 @芋道源码 (opens new window) 贡献 d09e484 (opens new window)
【修复】优化了 EChart 组件，避免出现首次异步加载数据时图表插件不显示问题，由 @飒沓如流星 (opens new window) 贡献 #797 (opens new window)
【修复】CacheRequestBodyFilter 导致 Spring Boot Admin 无法修改日志级别，由 @芋道源码 (opens new window) 贡献 8140e1c (opens new window)
【修复】主子表（ERP模式）删除主表数据，对应的子表数据还会显示，需要手动刷新之后才不显示，由 @顾北清 (opens new window) 贡献 #1382 (opens new window)
【修复】网关 AccessLogFilter 记录日志发生异常，静默处理，不影响请求返回，由 @芋道源码 (opens new window) 贡献 2e3e1b1 (opens new window)
【修复】网关缺少 CaffeineCacheManager 导致启动告警，由 @芋道源码 (opens new window) 贡献 f14dcd4 (opens new window)
【修复】Vue3 + element-plus 管理，uploadFile 上传失败后后续上传都将失败问题，由 @芋道源码 (opens new window) 贡献 2773b0e (opens new window)
【修复】ApiErrorLogServiceImpl 在微服务场景下，记录日志存在的循环调用的问题，由 @芋道源码 (opens new window) 贡献 99442ec (opens new window)

MALL 商城专区：

【修复】修复 directory 参数丢失导致无法创建目标文件目录的问题，由 @binny1024 (opens new window) 贡献 #156 (opens new window)
【修复】修复微信环境下获取完用户信息跳转的用户登录&绑定地址，由 @MaizaLin (opens new window) 贡献 #24 (opens new window)
【修复】修复店铺装修删除“弹窗广告”后，切换到基础设置页报错的问题，由 @卢越 (opens new window) 贡献 #792 (opens new window)
【修复】「店铺装修」处理热区选择链接之后，当前链接被重置为 undefined 的问题，由 @卢越 (opens new window) 贡献 #795 (opens new window)
【修复】「店铺装修」组件背景图片无法正常显示的问题、优化顶部导航栏搜索框，使其响应管理端装修，由 @卢越 (opens new window) 贡献 #157 (opens new window)
【修复】Kd100ExpressQueryRespDTO 中时间字段的处理，由 @binny1024 (opens new window) 贡献 #1381 (opens new window)
【修复】修复积分商品新增时校验商品是否参与其他活动校验失败，由 @芋道源码 (opens new window) 贡献 1b41254 (opens new window)

BPM 工作流专区：

【修复】BPMN 用户任务的用户任务的用户规则是“表单内用户字段”只有 1 个人，自动切换切换的问题，由 @芋道源码 (opens new window) 贡献 f287787 (opens new window)
【修复】避免在 BpmHttpRequestUtils 中重复添加 processInstanceId 参数，由 @芋道源码 (opens new window) 贡献 bfcc198 (opens new window)
【修复】流程预测时由于流程未开始或流程未真正抵达执行节点，无法获取 execution 导致的 Expression 流程表达式执行报错问题，由 @芋道源码 (opens new window) 贡献 dc7763e (opens new window)
【修复】buildConditionExpression 在流程预测时，因为变量不存在，导致 Unknow property 异常的问题，由 @芋道源码 (opens new window) 贡献 14d8c2b (opens new window)
【修复】SIMPLE 延迟任务时，租户上下文丢失的问题，由 @芋道源码 (opens new window) 贡献 51859af (opens new window)
【修复】BPMN 延迟任务修改后，不会直接更新到 BPMN XML 里的问题，由 @芋道源码 (opens new window) 贡献 75220bf (opens new window)
【修复】BPMN 任务监听器，“监听器 ID”、“定时器”无法保存的问题，由 @芋道源码 (opens new window) 贡献 a27d1a5 (opens new window)
【修复】子流程返回的 processInstanceId 不正确的问题，由 @芋道源码 (opens new window) 贡献 a27d1a5 (opens new window)
【修复】Simple 模型创建时不能设置字段权限问题修复，由 @Jason (opens new window) 贡献 ab8761d (opens new window)
【修复】流程模型设置时，「更多设置」不能选中表单项问题，由 @Jason (opens new window) 贡献 f14dead (opens new window)
【修复】并行分支使用包容网关实现，解决并行分支 + 条件分支存在无法执行的问题，由 @Jason (opens new window) 贡献 97cec289 (opens new window)、76d89067 (opens new window)
【修复】流程表单只读字段，不校验规则，由 @Jason (opens new window) 贡献 c8cf4dfa (opens new window)
【修复】子流程返回的 processInstanceId 不正确的问题，由 @芋道源码 (opens new window) 贡献 7ba084b (opens new window)
【修复】子流程支持流程 title 自定义标题，由 @芋道源码 (opens new window) 贡献 b766f8d (opens new window)
【修复】bpmn subProcess 存在 userTask NPE 的问题，由 @芋道源码 (opens new window) 贡献 989c4e4 (opens new window)
【修复】子流程发起人为列表时实际发起人会变成主流程发起人，由 @芋道源码 (opens new window) 贡献 376114a (opens new window)
【修复】存在加签时，退回报 Execution could not be found with id null，由 @芋道源码 (opens new window) 贡献 a4244ab (opens new window)
【修复】委派、转办时，owner 不重复设置，由 @芋道源码 (opens new window) 贡献 ab7d9fd (opens new window)
【修复】跨进程调用，无法回调 crm 的工作流结果的问题，由 @芋道源码 (opens new window) 贡献 8eea97a (opens new window)、3c5c3dd (opens new window)

# 🔨 Dependency Upgrades

【升级】mybatis-plus from 3.5.10.1 to 3.5.12
【升级】mybatis-plus-join from 1.4.13 to 1.5.

← 【v2025-09】【v2-6-1】2025-07-19→