开发指南
更新日志

【v2.5.0】2025-05-13

# 支持 Vben5.0 + antd 管理后台、新增 Cloud 单体启动模式、支持微信最新转账&公钥支付

# 📈 Statistic

总代码行数：258113
源码代码行数：160074
注释行数：59402
单元测试用例数：1113

# ⭐ New Features

【新增】AWS SDK for Java 1.x to 2.x，由 @puhui999 (opens new window) 贡献 #1219 (opens new window)
【新增】通过系统配置管理来设置系统是否可注册用户，由 @neviabit (opens new window) 贡献 #1236 (opens new window)
【重构】三方登录使用 justauth 官方 1.16.7，支持飞书等登录方式，由 @芋道源码 (opens new window) 贡献 #1334 (opens new window)
【重构】验证码使用 aj-captcha 官方 1.4.0，由 @芋道源码 (opens new window) 贡献 d765653 (opens new window)
【新增】Redis Stream 增加清理 Job，避免占用内存过多，由 @芋道源码 (opens new window) 贡献 361e50e (opens new window)
【新增】文件上传 api，增加 directory 参数，去除 path 参数，并支持按照日期分目录，由 @芋道源码 (opens new window) 贡献 #1335 (opens new window)
【新增】增加 REPORT 仪表盘设计器，由 @芋道源码 (opens new window) 贡献
【新增】增加 REPORT 自动登录功能，由 @芋道源码 (opens new window) 贡献 485ddf7 (opens new window)、1af6f95 (opens new window)
【新增】微服务的单体启动模式，由 @芋道源码 (opens new window) 贡献 18e4b1f (opens new window)、59234e1 (opens new window)
【优化】增强 MPJLambdaWrapperX 类，左连接后可以使用 betweenIfPresent 等，由 @fishSteak (opens new window) 贡献 #223 (opens new window)

Vue3 + element-plus 管理后台专区：

【优化】刷新时，主动加载最新菜单数据，由 @芋道源码 (opens new window) 贡献 #1236 (opens new window)
【新增】租户的切换功能，由 @芋道源码 (opens new window) 贡献 #1236 (opens new window)
【修复】切换主题后 hover 颜色设置未跟随主题色调整，由 @luyaozi (opens new window) 贡献 #64 (opens new window)

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

【优化】and schema 代码生成，支持主子表，由 @puhui999 (opens new window) 贡献 #75 (opens new window)、#1326 (opens new window)、#1328 (opens new window)、#78 (opens new window)、#1329 (opens new window)
【增加】Description 描述组件，由 @puhui999 (opens new window) 贡献 #80 (opens new window)
【优化】解决 lint 等相关报错，由 @xingyuv (opens new window) 贡献
【增加】个人中心、SSO、三方登录，由 @芋道源码 (opens new window) 贡献
【增加】表单构建功能 formCreate，由 @dhb52 (opens new window) 贡献 #81 (opens new window)
【新增】antd 标准代码生成，支持主子表，由 @puhui999 (opens new window) 贡献 #83 (opens new window)、#1329 (opens new window)、#1336 (opens new window)、#87 (opens new window)、#1339 (opens new window)
【迁移】工作流：用户分组、流程监听器、流程表达式，由 @子夜 (opens new window) 贡献 #90 (opens new window)、#91 (opens new window)、#92 (opens new window)
【迁移】工作流：流程实例，由 @子夜 (opens new window) 贡献 #94 (opens new window)、#96 (opens new window)、#100 (opens new window)
【迁移】工作流：流程分类、流程模型，由 @Jason (opens new window) 贡献 #93 (opens new window)

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

【新增】请求、路由、百度统计、概览、登录、系统管理模块，由 @puhui999 (opens new window) 贡献 #99 (opens new window)、#102 (opens new window)

MALL 商城专区：

【新增】商城订单取消时，额外校验支付单的状态，进一步兜底回调情况，由 @芋道源码 (opens new window) 贡献 3395a3d (opens new window)
【新增】拒绝用户协议与隐私协议，补充相关逻辑满足部分应用分发市场的审核需求，由 @芋道源码 (opens new window) 贡献 #144 (opens new window)
【新增】H5访问域名改为 .env 配置，由 @芋道源码 (opens new window) 贡献 #142 (opens new window)
【新增】App 售后筛选时，增加 status 过滤，由 @芋道源码 (opens new window) 贡献 349a4bb (opens new window)、4dde700 (opens new window)
【新增】前端直传，支持 H5，由 @芋道源码 (opens new window) 贡献 3e7fd52 (opens new window)
【新增】微信物流对接，由 @芋道源码 (opens new window) 贡献 a34de9f (opens new window)，由 @杨宇庆 (opens new window) 贡献 #1125 (opens new window)
【优化】客服聊天列表使用 scroll-view 原生组件，移除 z-paging 组件，由 @puhui999 (opens new window) 贡献 #146 (opens new window)

AI 大模型专区：

【新增】AI 工具新增 ToolContext，由 @Ren (opens new window) 贡献 #1325 (opens new window)
【新增】完善 AI 工作流，增加通义千问等模型的接入，由 @Ren (opens new window) 贡献 #1332 (opens new window)、#771 (opens new window)

PAY 支付专区：

【新增】微信支付 V3 公钥模式的集成，由 @芋道源码 (opens new window) 贡献 a2bfa7a (opens new window)、45e3667 (opens new window)

# 🐞 Bug Fixes

【修复】修复创建租户管理员时，select/update 自动拼接 user_id 问题，由 @Joyen (opens new window) 贡献 #1154 (opens new window)
【修复】网关传递 login-user 可能存在 usertype 不正确的问题，由 @芋道源码 (opens new window) 贡献 04bd6bf (opens new window)
【修复】网关 token 移除 login-user 头信息后重新赋值引用，由 @司徒俊杰 (opens new window) 贡献 04bd6bf (opens new window)
【修复】网关 CorsResponseHeaderFilter 跨域处理不正确的问题，由 @Before Trilogy (opens new window) 贡献 #177 (opens new window)
【修复】上传文件时网关报错的问题，由 @肖钦云 (opens new window) 贡献 #176 (opens new window)
【修复】修复 Logo 组件与 ToolHeader 组件、ElScrollbar 组件之间存在 1px 留白的问题，由 @ZG4vin (opens new window) 贡献 #762 (opens new window)

Vue3 + element-plus 管理后台专区：

【修复】解决修改用户头像，点击关闭弹框时重复弹框的 bug，由 @Joyen (opens new window) 贡献 #1154 (opens new window)

MALL 商城专区：

【修复】修复订单列表，因 user 为 null 导致其他数据渲染失败，由 @这夏天依然平凡 (opens new window) 贡献 #769 (opens new window)
【修复】回退操作时，进行中的任务取值不争取的问题，由 @aho (opens new window) 贡献 #1325 (opens new window)
【修复】订单取消收回优惠券失败导致管理员确认退款不成功的问题；优惠券在领取类型为指定发放和新人券时无法发送的问题；由 @puhui999 (opens new window) 贡献 #1315 (opens new window)
【修复】H5 之下，客服对话框中，不管先点表情还是＋号 ~ 弹起后，表情和＋切换，样式偏移了找不到内容，由 @puhui999 (opens new window) 贡献 #145 (opens new window)
【修复】修复拼团邀请小程序码位置，由 @puhui999 (opens new window) 贡献 #145 (opens new window)
【修复】拼团分享海报时，拼团人数不正确的问题，由 @芋道源码 (opens new window) 贡献 70f9c004 (opens new window)
【修复】addBrokerage 创建分销记录时，每个订单项，生成分销记录，由 @芋道源码 (opens new window) 贡献 ec76c1a (opens new window)
【修复】修复购物车页面刷新时底部导航消失的问题，由 @ForeverNewbee (opens new window) 贡献 #20 (opens new window)
【修复】商品不存在时，不展示 empty 的情况，由 @芋道源码 (opens new window) 贡献 c7d101c (opens new window)
【修复】解决微信小程序上传失败的问题（开启 es5 转换、postcss），由 @芋道源码 (opens new window) 贡献 8c821bf (opens new window)
【修复】下拉刷新"我的拼团订单列表"页时重置分页对象，否则会不断叠加重复的拼团订单，由 @SuchJack (opens new window) 贡献 #147 (opens new window)

BPM 工作流专区：

【修复】多实例使用 LinkedHashSet 保持顺序，由 @aho (opens new window) 贡献 #1307 (opens new window)
【修复】自选审批人时存在多个并行节点时审批人覆盖问题，由 @whc (opens new window) 贡献 #1340 (opens new window)

# 🔨 Dependency Upgrades

master-jdk17 分支：

【升级】spring-boot from 3.4.1 to 3.4.5
【升级】spring-boot-admin from 3.4.1 to 3.4.5
【升级】spring-doc from 2.7.0 to 2.8.3

所有分支：

【升级】mybatis-plus from 3.5.9 to 3.5.10.1
【升级】jimu-report from 1.8.0 to 1.9.4

← 配置读取【v2.4.2】2025-04-12→