? 总体说明

WxJava 4.8.0 是一次 横跨全部功能模块的深度升级与稳定性加固版本。本次迭代累计完成 70 余项关键更新，涵盖以下核心方向：

• 微信支付（V3/V2、商户转账、医保支付、跨境支付、收付通等）：上线多项全新接口；修复证书序列号生成异常、验签失败、请求路径错误等基础性缺陷；强化服务商模式与全公钥模式适配能力；优化回调处理机制、密钥加载逻辑及参数结构设计。
• 小程序（设备分组、用工管理、虚拟支付、道具直购、客服系统、短剧服务、物流对接、审核配额等）：扩展多类 API 能力；修正字段类型不一致问题；增强事件推送兼容性与数据模型完整性；同步完善相关文档说明。
• 企业微信（消息收发、审批流程、会话存档、智能机器人、工作台定制、打卡策略等）：新增多个实用接口；解决数据结构错位、路由匹配失效、配置类异常、递归调用死循环等问题；全面提升 SDK 运行健壮性。
• 开放平台（小程序类目管理、域名快速配置、接入指引等）：补充新接口支持，并修复 component_verify_ticket 生效时长不准等细节问题。
• 视频号 / 微信小店（订单管理、售后处理、优惠金额展示、换货流程等）：新增协商退换货、发货拒绝等关键接口；同步补全官方最新字段定义。
• 底层框架与基础设施（Gson、HttpClient5、Starter 组件、Quarkus/GraalVM 支持、序列化机制等）：开展大量兼容性修复、依赖版本升级、性能调优及文档补充工作。

本版本重点关注：

• 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 可能为 null 导致 NPE 的问题
• 付款码接口增加服务商模式适配支持 (#3686)
• 修复商户转账接口实际请求路径与文档不符的问题 (#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)
• 补全发货与结算消息所需参数 (#3

  

  799)
• 客服消息结构中新增 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 抛出 SecurityException 的问题 (#3752)
• 兼容低版本 Gson 的反序列化行为
• 新增 Quarkus/GraalVM 原生镜像构建支持 (#3732)
• 多个 Starter 默认网络超时时间统一设为 5000ms
• 补全 Javadoc 注释、代码示例与开发说明文档
• 优化 Redis/Redisson 配置类序列化逻辑（含 StackOverflow 异常修复）

源码地址：点击下载