🚀 概览

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)

📺 视频号 / 微信小店

• 新增售后协商、换货发货与拒绝发货接口 (#3770)

• 订单详情新增会员权益优惠字段 (#3806, #3767)

• 售后与订单接口字段对齐官方最新变更 (#3594)

• 新增换货相关字段 (#3609)

🧵 开放平台

• 消息路由支持小程序 (#3654)

• 添加小程序类目管理接口 (#3764)

• 完善快速配置域名相关接口 (#3739)

• 修改 component_verify_ticket 有效期为 12 小时 (#3683)

• 补充小程序审核额度与管理指南

⚙️ 框架层、Starter、基础设施

• 添加 HttpComponents Client 5 支持

• 统一各模块 API Host 字段为 apiHostUrl (#3694)

• 修复 Gson 在 Java 9+ 下访问 File#path 失败问题 (#3752)

• 修复低版本 Gson 不兼容问题

• 增加 Quarkus/GraalVM 原生镜像支持 (#3732)

• 多个 Starter 默认超时调整为 5000ms

• 完善 javadoc、示例与开发说明

• 优化 Redis/Redisson 配置类的序列化问题（含 StackOverflow 修复）