WxJava 标签 - Gitee.com

v4.8.0

# 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 修复）

7c6dbf1

2026-01-03 16:45

下载查看发行版

v4.7.9

fd3bbde

2025-11-28 22:36

下载

v4.7.8

cfe1f6d

2025-09-24 21:54

下载

v4.7.7

62f8998

2025-07-16 20:05

下载

v4.7.6

b0af2c7

2025-06-05 23:47

下载

v4.7.1

83bd92d

2025-01-13 08:51

下载

v4.7.2

3e48dc7

2025-01-24 22:18

下载

v4.7.3

25309e0

2025-03-18 12:58

下载

v4.7.4

0423e68

2025-04-08 08:39

下载

v4.7.5

fb57af7

2025-05-08 23:04

下载

v4.7.0

本次正式版本更新，企业微信模块主要增加了办公文档邮件相关接口及其他一些接口，并针对官方最新文档对一些接口做了调整，增加了一些参数；小程序模块则主要对物流相关接口进行了完善，修复了部分问题；公众号模块主要修复了部分接口问题，新增了支持多公众号配置的spring-boot-starter；微信支付模块则主要是增加平台收付通相关的一些接口，以及加入了对微信支付公钥的支持；其他模块则优化了部分接口，修复一些问题。具体更新日志如下：

## 企业微信
- #3164 增加停止发表企业朋友圈的接口
- #3208 修复OAuth2服务getAuthUserInfo字段大小写问题导致无法获取返回数据的问题
- #3212 增加微信客服回调事件支持
- #3216 修复 sun.security.util 在高版本 java 中无法访问的问题，改为通过 bouncycastle 库解析私钥
- #3218 增加获客助手事件回调通知
- #3225 多企业微信配置starter增加 http 客户端配置支持
- #3226 增加办公-文档管理模块相关接口
- #3228 增加办公-发送邮件模块相关接口
- #3243 增加获取敏感词规则列表和获取敏感词规则详情的接口
- #3256 获取客户群详情接口恢复state参数
- #3274 修复oa审批创建模板单选多选下拉组件企微信参数定义错误，拆分不共用模板详情实体
- #3333 设置应用在用户工作台展示的webview型数据时，支持enable_webview_click参数设置
- #3339 增加上传临时素材的重载方法
- #3367 获取审批申请详情接口中假勤组件新增时长支持按天分片信息
- #3377 企微审批增加附件相关参数
- #3394 修复“审批状态通知事件”企微回调XML序列化的bug
- #3395 增加"模板卡片事件推送"事件的相关属性
- #3397 增加会议室预定管理相关接口
- #3398 更新"企业微信日程"对象的相关字段
- #3405 增加获取已服务的外部联系人的接口
- #3437 微盘文件管理相关接口移除过期的userid参数
- #3438 第三方应用开发获取登录/访问用户身份接口返回字段调整
- OA审批模板增加位置的范围配置
- 修复更新模版卡片消息接口的json序列化问题
- 修复重复消息误判的问题
- 新增获取企业微信接口IP段的接口 !126
- 消息推送里添加更多的事件类型常量
- 第三方应用接口增加支持是否忽略SuiteAccessToken的post重载方法
- 获取客服账号列表接口 增加是否有管理权限的字段

## 小程序
- #3223 修复微信虚拟支付签名校验失败的问题
- #3231 内容安全服务和安全风控服务合并为小程序安全服务WxMaSecurityService
- #3247 即时配送服务增加获取运力id列表和更新物流信息的接口
- #3279 新增小程序推广员相关接口
- #3294 微信物流服务-消息组件传运单接口增加参数运力id
- #3308 查运单接口接口响应中运单信息字段变更
- #3343 媒资管理新增字段status以支持审核状态展示
- #3345 获取手机号 getPhoneNoInfo方法兼容旧版本
- #3360 增加支持多小程序账号的spring-boot-starter组件
- #3389 修复获取帐号基本信息的结果中customerType等字段为null的问题
- #3404 增加同城配送相关接口，同时为WxMaService增加了API签名支持
- #3409 获取运单数据接口返回对象里增加运单状态的字段
- #3417 同城配送订单接口字段优化
- 同城配送查询门店余额接口补充了几个遗漏属性，同时优化代码，避免可能出现的NPE问题

## 微信支付
- #3242 修改自动更新证书接口地址，使用WxPayConfig设置的payBaseUrl
- #3258 修复部分金额字段整数溢出问题
- #3263 分开管理p12证书私钥和pem证书
- #3278 增加解析商家转账批次回调通知的方法
- #3288 修复由于微信签名探测导致的验签错误的问题
- #3319 商家转账到零钱接口补充字段：请求新增`notify_url`、响应新增`batch_status`
- #3327 增加平台收付通（注销申请）相关接口
- #3340 增加直连商户付款码支付和撤销支付订单的V3版接口实现
- #3369 修复查询分账结果transaction_id取值问题
- #3392 修复V3客户端初始化时p12证书加载失败的问题
- #3402 支持配置微信支付公钥
- #3413 新增商户开户意愿申请单状态的枚举类
- #3424 加载证书前增加校验，减少不必要的异常日志输出
- spring-boot-starter模块增加测试沙盒开关配置项
- 主体类型枚举中增加开户意愿提交所需的的“个体小微”类型
- 企业付款到零钱接口请求类增加品牌红包字段 !117
- 修复使用setPrivateKeyString设置秘钥串时报“v3请求构造异常”的问题
- 修复商家转账到零钱-查询批次单needQueryDetail为false时非必传参数为null的问题
- 修复获取对私银行卡号开户银行接口解密失败的问题 !118
- 初始化v3客户端时，未使用p12证书且未设置证书序列号值才尝试加载证书
- 增加商家转账到零钱结果回调的解析方法
- 平台收付通APP支付接口新增SDK所需要签名参数
- 平台收付通（退款）增加垫付退款回补和查询垫付回补结果的接口
- 新增 平台收付通（补差）的3个接口方法

## 公众号
- #3203 修复使用okhttp方式永久素材下载接口存在的问题
- #3261 增加是否启用StableAccessToken的配置
- #3273 修复发送文件上传请求时Content-Type没有boundary的问题
- #3324 消息路由规则的事件增加正则匹配支持
- #3356 草稿箱模块新建草稿/修改草稿接口补充字段
- 优化配置类，增加新方法获取 OAuth 2.0重定向 URL 和 QR 连接重定向 URL !146
- 新增多公众号配置 wx-java-mp-multi-spring-boot-starter

## 视频号
- #3188 实现视频号助手相关接口
- #3238 新增会员功能相关API和消息处理 !122
- #3265 视频号线索[获取留资信息详情]接口兼容新版本返回的更多详细字段
- #3275 获取店铺基本信息接口返回数据 新增 店铺状态和 店铺原始ID字段
- #3295 小店获取订单详情接口补充部分返回值
- #3337 小店订单详情字段补充、售后新特性补充
- #3368 新增视频号助手-直播大屏数据、罗盘达人版API相关接口
- #3372 增加支持多视频号账号的spring-boot-starter组件
- #3414 小店API获取订单详情接口结果类新增几个属性
- #3426 更新视频号小店/微信小店类目、订单、商品、主页管理等相关接口
- #3427 新增罗盘商家版API、微信小店合作账号API相关接口以及订单待发货消息回调
- 增加分享员回调的相关方法
- 小店商品对象增加售后字段

## 开放平台
- #3207 新增小程序认证上传补充材料的接口
- #3232 小程序增加获取隐私接口检测结果的API
- #3249 修复haveOpen接口的请求地址
- #3250 调整并完善小程序认证相关代码文档
- #3270 修改获取授权方选项信息、设置授权方选项信息接口的地址
- #3347 新增小程序备案相关接口
- #3359 修复备案接口属性定义错误的问题
- #3431 增加半屏小程序管理相关接口
- 接入小程序认证（年审）相关接口，同时增加公共的文件上传方法

## 其他公共问题
- #3348 修复无法获取正确文件名的问题
- #3217 增加 solon-plugins 适配
- 修复下载文件相关接口获取文件名的问题

8fe1e6e

2024-12-24 13:21

下载查看发行版

v4.6.0

本次正式版本更新，主要是增加了视频号模块，已接入大部分接口；企业微信模块主要修复了一些问题，增加了部分实用的接口，针对官方最新文档对一些接口做了调整；小程序模块则主要增加了增加了openApi管理、发货信息管理、短剧媒资管理、小程序虚拟支付、退货组件等相关接口，优化部分代码；公众号模块主要增加获取稳定版接口调用凭据的接口；微信支付模块则主要是补充完善部分接口，新增一些字段的支持；其他模块则优化了部分接口，修复一些问题，新增了相关参数。具体更新日志如下：

## 企业微信
- #2993 敏感词更新接口参数根据最新官方文档进行调整
- #3002 修复新增外部联系人回调去重错误问题
- #3016 增加获取客户数据统计接待人员明细数据的接口，并修复获取企业汇总数据接口返回值问题
- #3037 修复第三方审批不同回调下实体缺少字段问题
- #3047 获取员工打卡规则接口返回值增加添加排班信息
- #3055 获取访问用户敏感信息接口返回值增加若干字段
- #3059 客户详情接口新增视频号相关字段
- #3064 增加获客助手相关的接口
- #3079 增加提醒成员群发和停止企业群发的接口
- #3145 创建企业群发接口新增chat_id_list和allow_select两个参数
- #3149 增加支持企业微信多账号配置的starter
- #3156 优化企业微信应用参数未配置时的初始化逻辑
- #3174 批量获取审批单号接口请求中的筛选类型增加审批单类型属性
- #3178 修复会话存档反序列化接口中uint64相关字段定义，使用BigInteger类型
- #3179 群机器人发送消息接口中增加发送语音类型消息的方法
- #3184 新增第三方组件可查询获客链接的使用详情的接口
- #3185 获取审批申请详情接口增加对位置控件和公式控件的支持
- #3186 增加获取用户登录身份和获取用户二次验证信息的接口
- #3187 批量获取审批单号接口方法增加对新分页字段的支持
- #3190 获取客户群详情接口响应类中增加member_version字段，并移除过期的state字段
- 修复第三方获取访问用户身份等接口地址为最新的

## 公众号
- #3006 模板消息发送接口增加字段client_msg_id
- #3078 模板消息获得模板ID的接口增加选用类目模板的关键词的参数
- #3084 增加获取稳定版接口调用凭据的接口
- #3142 订阅通知下发接口返回消息id
- #3170 修复is_snapshotuser(是否为快照页模式虚拟账号)参数位置，在getAccessToken接口请求时返回
- #3196 修复materialImageOrVoiceDownload接口无法正常刷新AccessToken的问题

## 小程序
- #2998 增加获取稳定版接口调用凭据的接口，通过设置WxMaConfig#useStableAccessToken方法去开启使用稳定版接口
- #3024 发送设备消息接口请求类增加设备型号id字段
- #3077 增加openApi管理的接口支持
- #3083 增加发货信息管理相关接口
- #3115 增加短剧媒资管理相关接口支持
- #3122 增加小程序虚拟支付的相关接口
- #3124 实现查询 URL Link的接口
- #3194 优化openApi部分接口（getApiQuota 和 getRidInfo ）响应类的部分字段信息
- 代码审核状态查询接口返回增加三个参数
- 增加退货组件相关接口，同时绑定/解绑物流账号接口增加缺失返回值
- 添加获取 NFC 的小程序 scheme 接口

## 微信支付
- #3009 商家转账到零钱接口增加转账场景ID字段
- #3023 增加根据账户类型查询二级商户实时余额的接口，同时修复批量转账订单相关接口的问题
- #3045 修复分账接收方列表”姓名“字段加密功能
- #3056 优化支付/退款结果解析，增加对V3版本服务商的下单/退款支持
- #3063 增加服务商模式关闭订单的接口
- #3066 增加服务商模式V3查询订单的接口支持
- #3070 优化服务商模式下下单接口，去掉部分重复代码
- #3089 新增代金券详情接口返回类增加商户单据号字段
- #3102 修复申请资金账单接口请求里的参数名称
- #3103 v3发起商家转账接口的结果类增加批次状态字段
- #3106 退款结果通知里退款金额等字段类型修复
- #3111 分账相关接口增加子商户应用ID字段
- #3128 提供扩展httpclientbuilder的能力
- #3136 根据最新官方文档补全部分接口的字段
- #3138 增加接查询结算账户修改申请状态的接口
- #3154 修复按日下载提现异常文件接口响应异常
- #3162 接入服务商微信支付分签约计划相关接口功能
- #3169 新增商户开户意愿确认相关接口
- #3171 修改微信支付分签约计划部分字段类型
- 二级商户进件申请接口请求参数里的金融机构许可证图片字段修改为正确的类型
- 优化复用订单通知SignatureHeader
- 分账模块解冻剩余资金接口返回类增加几个字段
- 增加微信支付服务商V3版本说明
- 增加服务商查询单笔退款的v3接口
- 增加服务商模式下分账通知的解析方法
- 新增v3分账查询接口，同时修改分账查询结果接口增加分账明细单号字段detail_id
- 服务商支付通知接口增加若干字段
- 退款查询接口的结果类增加退款总金额、代金券退款总金额、用户退款金额等字段
- 重构分账相关接口，重命名接口方法和请求实体，合并分账v2、v3实现类，方便同时使用
- 优化WxPayPartnerOrderQueryV3Result类中Payer字段
- 优化微信支付异常处理代码，兼容混乱且变态的微信官方字段命名习惯

## 视频号
- #2991 增加视频号模块，实现视频号大部分相关接口
- #3167 视频号小店分享员订单接口增加几个返回参数，并修复openid参数类型
- 增加视频号小店的同意和拒绝修改地址的接口 !114
- 视频号小店获取订单详情接口增加部分字段 !113

## 开放平台
- #3040 小程序管理部分接口返回结果类增加参数，同时增加新的接口 (查询小程序线上代码的可见状态，获取小程序业务域名校验文件)
- #3116 云开发/云托管环境共享接口增加请求环境源参数
- #3182 设置服务器域名接口方法增加tcp合法域名和 udp合法域名的参数
- #3189 增加试用小程序快速认证接口
- #3198 修改H5版授权链接为新版链接
- #3083 增加第三方平台的购物订单管理等接口
- 修复试用小程序快速认证字段类型错误

## 其他公共问题
- #2999 修复异步消息路由报错的问题
- #3005 提供更新access_token的消费接口
- 修复AppId 和 appid 同时存在导致lombok生成代码异常的问题
- 修复使用java.nio.file.Files打开公私钥文件无法释放句柄的问题
- 兼容SpringBoot3中使用的Jedis4版本
- 提供方法方便第三方类使用 XStreamTransformer进行序列化, 以及支持XStream 1.4.18 以上增加安全许可

7198a58

2023-04-22 23:16

下载

v4.5.0

e72991c

2023-03-06 13:25

下载

v4.4.0

bf68104

2022-08-21 23:14

下载查看发行版

v4.3.0