WxJava 4.8.0 正式版本
🚀 概览
WxJava 4.8.0 是一次 覆盖全模块的大规模功能增强与稳定性提升版本。本次更新共包含 超过 70+ 项改进,涉及:
- 微信支付(V3、V2、商家转账、医保、境外支付、收付通等):新增多项重要接口;修复了证书序列号错误、签名验证失败、路径错误等低级错误;增强服务商模式、全公钥模式的支持;优化回调、密钥处理、参数结构。
- 小程序(设备组、用工、虚拟支付、道具直购、客服管理、短剧、物流、审核额度等):新增多条 API;修复字段类型问题;增强事件推送与数据结构;补全文档。
- 企业微信(消息、审批、会话存档、智能机器人、工作台、打卡规则等):增加接口功能,修复数据结构、路由、配置类、递归调用等问题,并完善 SDK 稳定性。
- 开放平台(小程序类目、快速配置域名、管理指南等):新增接口并修正 ticket 时效等问题。
- 视频号 / 微信小店(订单、售后、优惠金额、换货等):新增售后与协商接口并补充字段。
- 基础设施与框架层(Gson、HttpClient5、Starter、Quarkus/GraalVM、序列化等):大量兼容性修复、依赖升级、性能优化及文档补全。
本次版本特别强调:
- 接口补全:尤其是微信支付、小程序、企业微信的最新能力。
- 健壮性与正确性:修复诸多空指针、字段拼写、签名错误、序列号生成逻辑等长期遗留问题。
- 更佳的 Starter 与插件体验:统一 API Host 字段命名、支持 HttpClient 5、连接池优化、默认超时调整等重大优化。
- 更完善的文档体系:全面补充支付、小程序、企业微信等关键模块的使用说明。
🏢 企业微信
- 修复群聊变更事件
MemChangeList的字段命名规范问题 (#3827) - 新增应用管理员列表接口 (#3823)
- 修复
WxCpRedisConfigImpl.getWebhookKey()无限递归问题 (#3821) - 新增智能机器人消息收发能力 (#3815)
- 会话存档支持 voiptext 类型 (#3598)
- 修复更新用户接口导致重置直属领导的问题 (#3620)
- 修复审批流程 Demo 的兼容性与编译错误
- 新增 markdown_v2 消息类型支持 (#3725)
- 提交审批申请接口新增 process 参数 (#3751)
- 修复会话存档重复初始化导致接口超限的问题 (#3755)
- 获取企业打卡规则接口添加多个字段(含 late_rule) (#3323)
- 获取会议详情接口补充官方新增字段 (#3660)
- 获取“联系我”列表返回新增 next_cursor (#3746)
- 修复解密回调过程可能抛出的异常 (#3756)
- 第三方应用 agentId 类型不一致导致路由匹配失败的问题 (#3557)
- 自定义工作台参数修复无法生效的问题 (#3697)
💰 微信支付
新增能力
- 新增免确认收款授权模式(商户转账)(#3717)
- 新增实名验证接口 (#3814)
- 新增 V3 医保完整接口支持 (#3816)
- 新增微信预约扣费接口 (#3688)
- 新增押金支付能力 (#3720)
- 新增运营工具-商家转账接口 (#3507)
- 新增境外微信支付支持 (#3618)
- V3 服务商申请退款接口 (#3737)
- 商家转账用户授权免确认接口 (#3753)
- 平台收付通提现回调参数补充 (#3494)
修复与优化
- 修复证书序列号生成条件错误问题 (#3825)
- 支付回调结果解析提供更严格的报错判断
- 下单接口新增 prepayId 字段 (#3798)
- 修复委托代扣协议字段名拼写问题 (#3813)
- 支付公钥模式下 serialNumber 空指针问题修复
- 付款码 API 增加服务商模式支持 (#3686)
- 修复商户转账 API 路径错误 (#3797)
- 修复 fullPublicKeyModel 配置无效问题 (#3608)
- 修复验证器未初始化导致 V3 请求异常 (#3547)
- 修复只配置 privateKeyString 时私钥初始化失败 (#3591)
- 修复 V3 公钥模式未设置 Wechatpay-Serial 导致验签失败 (#3548)
- 修复微信分账通知验签失败问题 (#3634)
- 修复退款接口因 SSL 客户端证书未发送导致报错 (#3640)
- 修复从 base64 加载私钥时的双重解码问题 (#3765)
- 优化请求结构、统一抽取公共逻辑、规范字段命名
🧩 小程序
新增能力
- 新增设备组相关接口 (#3818)
- 新增用工关系 API (#3812)
- 新增小游戏道具直购 present_goods 接口 (#3811)
- 新增多端登录 code2VerifyInfo (#3524)
- 新增虚拟支付更多接口 (#3645)
- 新增客服管理接口 (#3678)
- 新增交易投诉接口 (#3519)
- 新增群入口敏感数据解密 (#3736)
- 新增审核额度管理指南
- 新增企微客服增删查接口 (#3681)
修复与优化
- 修复 Express Order Cargo 类型(支持小数值)(#3802)
- 发货与结算消息参数补全 (#3799)
- 客服消息增加 AI 上下文字段 (#3795)
- 修复同城配送签名错误(补充 RSA 序列号)(#3620)
- 修复退货组件请求方法错误 (#3675)
- 修复智能裁剪接口请求类型错误 (#3692)
- 补全文档(虚拟支付、云开发、数据分析、短剧等)
- 小程序事件推送完善 JSON 格式支持 (#3376)
📺 视频号 / 微信小店
🧵 开放平台
- 消息路由支持小程序 (#3654)
- 添加小程序类目管理接口 (#3764)
- 完善快速配置域名相关接口 (#3739)
- 修改 component_verify_ticket 有效期为 12 小时 (#3683)
- 补充小程序审核额度与管理指南