{"release":{"tag":{"name":"v4.8.0","path":"/binary/weixin-java-tools/tags/v4.8.0","tree_path":"/binary/weixin-java-tools/tree/v4.8.0","message":"# WxJava 4.8.0 正式版本\r\n\r\n## 🚀 概览\r\n\r\nWxJava 4.8.0 是一次 **覆盖全模块的大规模功能增强与稳定性提升版本**。本次更新共包含 **超过 70+ 项改进**，涉及：\r\n\r\n* **微信支付（V3、V2、商家转账、医保、境外支付、收付通等）**：新增多项重要接口；修复了证书序列号错误、签名验证失败、路径错误等低级错误；增强服务商模式、全公钥模式的支持；优化回调、密钥处理、参数结构。\r\n* **小程序（设备组、用工、虚拟支付、道具直购、客服管理、短剧、物流、审核额度等）**：新增多条 API；修复字段类型问题；增强事件推送与数据结构；补全文档。\r\n* **企业微信（消息、审批、会话存档、智能机器人、工作台、打卡规则等）**：增加接口功能，修复数据结构、路由、配置类、递归调用等问题，并完善 SDK 稳定性。\r\n* **开放平台（小程序类目、快速配置域名、管理指南等）**：新增接口并修正 ticket 时效等问题。\r\n* **视频号 / 微信小店（订单、售后、优惠金额、换货等）**：新增售后与协商接口并补充字段。\r\n* **基础设施与框架层（Gson、HttpClient5、Starter、Quarkus/GraalVM、序列化等）**：大量兼容性修复、依赖升级、性能优化及文档补全。\r\n\r\n本次版本特别强调：\r\n\r\n* **接口补全**：尤其是微信支付、小程序、企业微信的最新能力。\r\n* **健壮性与正确性**：修复诸多空指针、字段拼写、签名错误、序列号生成逻辑等长期遗留问题。\r\n* **更佳的 Starter 与插件体验**：统一 API Host 字段命名、支持 HttpClient 5、连接池优化、默认超时调整等重大优化。\r\n* **更完善的文档体系**：全面补充支付、小程序、企业微信等关键模块的使用说明。\r\n\r\n\r\n---\r\n\r\n\r\n## 🏢 企业微信\r\n\r\n* 修复群聊变更事件 `MemChangeList` 的字段命名规范问题 (#3827)\r\n* 新增应用管理员列表接口 (#3823)\r\n* 修复 `WxCpRedisConfigImpl.getWebhookKey()` 无限递归问题 (#3821)\r\n* 新增智能机器人消息收发能力 (#3815)\r\n* 会话存档支持 voiptext 类型 (#3598)\r\n* 修复更新用户接口导致重置直属领导的问题 (#3620)\r\n* 修复审批流程 Demo 的兼容性与编译错误\r\n* 新增 markdown_v2 消息类型支持 (#3725)\r\n* 提交审批申请接口新增 process 参数 (#3751)\r\n* 修复会话存档重复初始化导致接口超限的问题 (#3755)\r\n* 获取企业打卡规则接口添加多个字段（含 late_rule） (#3323)\r\n* 获取会议详情接口补充官方新增字段 (#3660)\r\n* 获取“联系我”列表返回新增 next_cursor (#3746)\r\n* 修复解密回调过程可能抛出的异常 (#3756)\r\n* 第三方应用 agentId 类型不一致导致路由匹配失败的问题 (#3557)\r\n* 自定义工作台参数修复无法生效的问题 (#3697)\r\n\r\n---\r\n\r\n## 💰 微信支付\r\n\r\n#### 新增能力\r\n\r\n* 新增免确认收款授权模式（商户转账）(#3717)\r\n* 新增实名验证接口 (#3814)\r\n* 新增 V3 医保完整接口支持 (#3816)\r\n* 新增微信预约扣费接口 (#3688)\r\n* 新增押金支付能力 (#3720)\r\n* 新增运营工具-商家转账接口 (#3507)\r\n* 新增境外微信支付支持 (#3618)\r\n* V3 服务商申请退款接口 (#3737)\r\n* 商家转账用户授权免确认接口 (#3753)\r\n* 平台收付通提现回调参数补充 (#3494)\r\n\r\n#### 修复与优化\r\n\r\n* 修复证书序列号生成条件错误问题 (#3825)\r\n* 支付回调结果解析提供更严格的报错判断\r\n* 下单接口新增 prepayId 字段 (#3798)\r\n* 修复委托代扣协议字段名拼写问题 (#3813)\r\n* 支付公钥模式下 serialNumber 空指针问题修复\r\n* 付款码 API 增加服务商模式支持 (#3686)\r\n* 修复商户转账 API 路径错误 (#3797)\r\n* 修复 fullPublicKeyModel 配置无效问题 (#3608)\r\n* 修复验证器未初始化导致 V3 请求异常 (#3547)\r\n* 修复只配置 privateKeyString 时私钥初始化失败 (#3591)\r\n* 修复 V3 公钥模式未设置 Wechatpay-Serial 导致验签失败 (#3548)\r\n* 修复微信分账通知验签失败问题 (#3634)\r\n* 修复退款接口因 SSL 客户端证书未发送导致报错 (#3640)\r\n* 修复从 base64 加载私钥时的双重解码问题 (#3765)\r\n* 优化请求结构、统一抽取公共逻辑、规范字段命名\r\n\r\n---\r\n\r\n## 🧩 小程序\r\n\r\n#### 新增能力\r\n\r\n* 新增设备组相关接口 (#3818)\r\n* 新增用工关系 API (#3812)\r\n* 新增小游戏道具直购 present_goods 接口 (#3811)\r\n* 新增多端登录 code2VerifyInfo (#3524)\r\n* 新增虚拟支付更多接口 (#3645)\r\n* 新增客服管理接口 (#3678)\r\n* 新增交易投诉接口 (#3519)\r\n* 新增群入口敏感数据解密 (#3736)\r\n* 新增审核额度管理指南\r\n* 新增企微客服增删查接口 (#3681)\r\n\r\n#### 修复与优化\r\n\r\n* 修复 Express Order Cargo 类型（支持小数值）(#3802)\r\n* 发货与结算消息参数补全 (#3799)\r\n* 客服消息增加 AI 上下文字段 (#3795)\r\n* 修复同城配送签名错误（补充 RSA 序列号）(#3620)\r\n* 修复退货组件请求方法错误 (#3675)\r\n* 修复智能裁剪接口请求类型错误 (#3692)\r\n* 补全文档（虚拟支付、云开发、数据分析、短剧等）\r\n* 小程序事件推送完善 JSON 格式支持 (#3376)\r\n\r\n---\r\n\r\n## 📺 视频号 / 微信小店\r\n\r\n* 新增售后协商、换货发货与拒绝发货接口 (#3770)\r\n* 订单详情新增会员权益优惠字段 (#3806, #3767)\r\n* 售后与订单接口字段对齐官方最新变更 (#3594)\r\n* 新增换货相关字段 (#3609)\r\n\r\n---\r\n\r\n## 🧵 开放平台\r\n\r\n* 消息路由支持小程序 (#3654)\r\n* 添加小程序类目管理接口 (#3764)\r\n* 完善快速配置域名相关接口 (#3739)\r\n* 修改 component_verify_ticket 有效期为 12 小时 (#3683)\r\n* 补充小程序审核额度与管理指南\r\n\r\n---\r\n\r\n## ⚙️ 框架层、Starter、基础设施\r\n\r\n* 添加 HttpComponents Client 5 支持\r\n* 统一各模块 API Host 字段为 apiHostUrl (#3694)\r\n* 修复 Gson 在 Java 9+ 下访问 File#path 失败问题 (#3752)\r\n* 修复低版本 Gson 不兼容问题\r\n* 增加 Quarkus/GraalVM 原生镜像支持 (#3732)\r\n* 多个 Starter 默认超时调整为 5000ms\r\n* 完善 javadoc、示例与开发说明\r\n* 优化 Redis/Redisson 配置类的序列化问题（含 StackOverflow 修复）\r","commit":{"id":"7c6dbf15e44dcd521703f1a8c2f6b2d381b9759b","short_id":"7c6dbf1","title":":art: #3827【企业微信】修复群聊变更事件MemChangeList字段命名规范问题","title_markdown":"\u003Cimg class=\"emoji\" alt=\":art:\" style=\"vertical-align: middle\" src=\"https://cn-assets.gitee.com/assets/emoji/art-4973ecf8f6e8c4495c2e9a0531cb531a.png\" width=\"14\" height=\"14\"\u003E#3827【企业微信】修复群聊变更事件MemChangeList字段命名规范问题","description":"","description_markdown":"","message":":art: #3827【企业微信】修复群聊变更事件MemChangeList字段命名规范问题\n\n","message_markdown":"\u003Cimg class=\"emoji\" alt=\":art:\" style=\"vertical-align: middle\" src=\"https://cn-assets.gitee.com/assets/emoji/art-4973ecf8f6e8c4495c2e9a0531cb531a.png\" width=\"14\" height=\"14\"\u003E#3827【企业微信】修复群聊变更事件MemChangeList字段命名规范问题","detail_path":"/binary/weixin-java-tools/commit/7c6dbf15e44dcd521703f1a8c2f6b2d381b9759b","commits_path":"/binary/weixin-java-tools/commits/7c6dbf15e44dcd521703f1a8c2f6b2d381b9759b","tree_path":"/binary/weixin-java-tools/tree/7c6dbf15e44dcd521703f1a8c2f6b2d381b9759b","author":{"name":"Copilot","email":"198982749+Copilot@users.noreply.github.com","username":null,"user_path":null,"enterprise_user_path":null,"image_path":"no_portrait.png#Copilot-","is_gitee_user":false,"is_enterprise_user":null,"widget_url":null},"committer":{"name":"GitHub GPG Bot","email":"noreply@github.com","username":"github-bot","user_path":"/github-bot","enterprise_user_path":null,"image_path":"https://foruda.gitee.com/avatar/1677201096080835335/10181580_github-bot_1639517195.png!avatar30","is_gitee_user":true,"is_enterprise_user":null,"widget_url":""},"authored_date":"2026-01-03T16:45:03+08:00","committed_date":"2026-01-03T16:45:03+08:00","signature":null,"build_state":null},"archive_path":"/binary/weixin-java-tools/repository/archive/v4.8.0","signature":null},"operating":{"edit":false,"download":true,"destroy":false,"enterprise_forbid_zip":false},"release":{"title":"4.8.0 / 2026-01-03","path":"/binary/weixin-java-tools/releases/tag/v4.8.0","tag_path":"/binary/weixin-java-tools/tree/v4.8.0","project_id":1094677,"created_at":"2026-01-04T00:12:29+08:00","is_prerelease":false,"description":"# WxJava 4.8.0 正式版本\r\n\r\n## 🚀 概览\r\n\r\nWxJava 4.8.0 是一次 **覆盖全模块的大规模功能增强与稳定性提升版本**。本次更新共包含 **超过 70+ 项改进**，涉及：\r\n\r\n* **微信支付（V3、V2、商家转账、医保、境外支付、收付通等）**：新增多项重要接口；修复了证书序列号错误、签名验证失败、路径错误等低级错误；增强服务商模式、全公钥模式的支持；优化回调、密钥处理、参数结构。\r\n* **小程序（设备组、用工、虚拟支付、道具直购、客服管理、短剧、物流、审核额度等）**：新增多条 API；修复字段类型问题；增强事件推送与数据结构；补全文档。\r\n* **企业微信（消息、审批、会话存档、智能机器人、工作台、打卡规则等）**：增加接口功能，修复数据结构、路由、配置类、递归调用等问题，并完善 SDK 稳定性。\r\n* **开放平台（小程序类目、快速配置域名、管理指南等）**：新增接口并修正 ticket 时效等问题。\r\n* **视频号 / 微信小店（订单、售后、优惠金额、换货等）**：新增售后与协商接口并补充字段。\r\n* **基础设施与框架层（Gson、HttpClient5、Starter、Quarkus/GraalVM、序列化等）**：大量兼容性修复、依赖升级、性能优化及文档补全。\r\n\r\n本次版本特别强调：\r\n\r\n* **接口补全**：尤其是微信支付、小程序、企业微信的最新能力。\r\n* **健壮性与正确性**：修复诸多空指针、字段拼写、签名错误、序列号生成逻辑等长期遗留问题。\r\n* **更佳的 Starter 与插件体验**：统一 API Host 字段命名、支持 HttpClient 5、连接池优化、默认超时调整等重大优化。\r\n* **更完善的文档体系**：全面补充支付、小程序、企业微信等关键模块的使用说明。\r\n\r\n\r\n---\r\n\r\n\r\n## 🏢 企业微信\r\n\r\n* 修复群聊变更事件 `MemChangeList` 的字段命名规范问题 (#3827)\r\n* 新增应用管理员列表接口 (#3823)\r\n* 修复 `WxCpRedisConfigImpl.getWebhookKey()` 无限递归问题 (#3821)\r\n* 新增智能机器人消息收发能力 (#3815)\r\n* 会话存档支持 voiptext 类型 (#3598)\r\n* 修复更新用户接口导致重置直属领导的问题 (#3620)\r\n* 修复审批流程 Demo 的兼容性与编译错误\r\n* 新增 markdown_v2 消息类型支持 (#3725)\r\n* 提交审批申请接口新增 process 参数 (#3751)\r\n* 修复会话存档重复初始化导致接口超限的问题 (#3755)\r\n* 获取企业打卡规则接口添加多个字段（含 late_rule） (#3323)\r\n* 获取会议详情接口补充官方新增字段 (#3660)\r\n* 获取“联系我”列表返回新增 next_cursor (#3746)\r\n* 修复解密回调过程可能抛出的异常 (#3756)\r\n* 第三方应用 agentId 类型不一致导致路由匹配失败的问题 (#3557)\r\n* 自定义工作台参数修复无法生效的问题 (#3697)\r\n\r\n---\r\n\r\n## 💰 微信支付\r\n\r\n#### 新增能力\r\n\r\n* 新增免确认收款授权模式（商户转账）(#3717)\r\n* 新增实名验证接口 (#3814)\r\n* 新增 V3 医保完整接口支持 (#3816)\r\n* 新增微信预约扣费接口 (#3688)\r\n* 新增押金支付能力 (#3720)\r\n* 新增运营工具-商家转账接口 (#3507)\r\n* 新增境外微信支付支持 (#3618)\r\n* V3 服务商申请退款接口 (#3737)\r\n* 商家转账用户授权免确认接口 (#3753)\r\n* 平台收付通提现回调参数补充 (#3494)\r\n\r\n#### 修复与优化\r\n\r\n* 修复证书序列号生成条件错误问题 (#3825)\r\n* 支付回调结果解析提供更严格的报错判断\r\n* 下单接口新增 prepayId 字段 (#3798)\r\n* 修复委托代扣协议字段名拼写问题 (#3813)\r\n* 支付公钥模式下 serialNumber 空指针问题修复\r\n* 付款码 API 增加服务商模式支持 (#3686)\r\n* 修复商户转账 API 路径错误 (#3797)\r\n* 修复 fullPublicKeyModel 配置无效问题 (#3608)\r\n* 修复验证器未初始化导致 V3 请求异常 (#3547)\r\n* 修复只配置 privateKeyString 时私钥初始化失败 (#3591)\r\n* 修复 V3 公钥模式未设置 Wechatpay-Serial 导致验签失败 (#3548)\r\n* 修复微信分账通知验签失败问题 (#3634)\r\n* 修复退款接口因 SSL 客户端证书未发送导致报错 (#3640)\r\n* 修复从 base64 加载私钥时的双重解码问题 (#3765)\r\n* 优化请求结构、统一抽取公共逻辑、规范字段命名\r\n\r\n---\r\n\r\n## 🧩 小程序\r\n\r\n#### 新增能力\r\n\r\n* 新增设备组相关接口 (#3818)\r\n* 新增用工关系 API (#3812)\r\n* 新增小游戏道具直购 present_goods 接口 (#3811)\r\n* 新增多端登录 code2VerifyInfo (#3524)\r\n* 新增虚拟支付更多接口 (#3645)\r\n* 新增客服管理接口 (#3678)\r\n* 新增交易投诉接口 (#3519)\r\n* 新增群入口敏感数据解密 (#3736)\r\n* 新增审核额度管理指南\r\n* 新增企微客服增删查接口 (#3681)\r\n\r\n#### 修复与优化\r\n\r\n* 修复 Express Order Cargo 类型（支持小数值）(#3802)\r\n* 发货与结算消息参数补全 (#3799)\r\n* 客服消息增加 AI 上下文字段 (#3795)\r\n* 修复同城配送签名错误（补充 RSA 序列号）(#3620)\r\n* 修复退货组件请求方法错误 (#3675)\r\n* 修复智能裁剪接口请求类型错误 (#3692)\r\n* 补全文档（虚拟支付、云开发、数据分析、短剧等）\r\n* 小程序事件推送完善 JSON 格式支持 (#3376)\r\n\r\n---\r\n\r\n## 📺 视频号 / 微信小店\r\n\r\n* 新增售后协商、换货发货与拒绝发货接口 (#3770)\r\n* 订单详情新增会员权益优惠字段 (#3806, #3767)\r\n* 售后与订单接口字段对齐官方最新变更 (#3594)\r\n* 新增换货相关字段 (#3609)\r\n\r\n---\r\n\r\n## 🧵 开放平台\r\n\r\n* 消息路由支持小程序 (#3654)\r\n* 添加小程序类目管理接口 (#3764)\r\n* 完善快速配置域名相关接口 (#3739)\r\n* 修改 component_verify_ticket 有效期为 12 小时 (#3683)\r\n* 补充小程序审核额度与管理指南\r\n\r\n---\r\n\r\n## ⚙️ 框架层、Starter、基础设施\r\n\r\n* 添加 HttpComponents Client 5 支持\r\n* 统一各模块 API Host 字段为 apiHostUrl (#3694)\r\n* 修复 Gson 在 Java 9+ 下访问 File#path 失败问题 (#3752)\r\n* 修复低版本 Gson 不兼容问题\r\n* 增加 Quarkus/GraalVM 原生镜像支持 (#3732)\r\n* 多个 Starter 默认超时调整为 5000ms\r\n* 完善 javadoc、示例与开发说明\r\n* 优化 Redis/Redisson 配置类的序列化问题（含 StackOverflow 修复）\r\n","author":{"name":"Binary Wang","username":"binary","path":"/binary","avatar_url":"https://foruda.gitee.com/avatar/1676895083909070347/5303_binary_1649404280.png!avatar30"},"attach_files":[],"zip_download_url":"/binary/weixin-java-tools/releases/tag/v4.8.0.zip","tar_download_url":"/binary/weixin-java-tools/releases/tag/v4.8.0.tar.gz"}}}