Skip to content

4.8.0 / 2026-01-03

Latest

Choose a tag to compare

@binarywang binarywang released this 03 Jan 16:10

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)

📺 视频号 / 微信小店

  • 新增售后协商、换货发货与拒绝发货接口 (#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 修复)