开放代码社区 › WxJava 微信开发 Java SDK
WxJava 微信开发 Java SDK
开发工具JavaWxJava 是一个面向微信生态后端开发的 Java SDK，封装微信支付、开放平台、公众号、企业微信、视频号与小程序等模块的接口调用。开发者可通过 Maven 或 Gradle 引入对应模块，快速完成服务端接入、消息处理与支付等业务开发，适合 Java 后端项目集成微信能力。
仓库地址
https://gitee.com/binary/weixin-java-tools.gitREADME
## WxJava - 微信开发 Java SDK
[](https://github.com/binarywang/WxJava)
[](https://gitee.com/binary/weixin-java-tools)
[](https://gitcode.com/binary/WxJava)
[](https://github.com/binarywang/WxJava/releases)
[](https://central.sonatype.com/artifact/com.github.binarywang/wx-java/versions)
[](https://circleci.com/gh/binarywang/WxJava/tree/develop)
[](https://www.jetbrains.com/?from=WxJava-weixin-java-tools)
[](https://opensource.org/licenses/Apache-2.0)
[](https://deepwiki.com/binarywang/WxJava)
[<img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=6de6147050c94db4aedfd7098d19f8d8&claim_uid=mwKh0tILBfjlezR" alt="Featured｜HelloGitHub" width="250" height="55">](https://hellogithub.com/repository/6de6147050c94db4aedfd7098d19f8d8)
[<img src="https://trendshift.io/api/badge/repositories/12152" alt="binarywang/WxJava | 趋势转变" width="250" height="55">](https://trendshift.io/repositories/12152)
[<img src="https://api.star-history.com/badge?repo=binarywang/WxJava" alt="Star History" width="250" height="55">](https://www.star-history.com/binarywang/wxjava)
### 微信 `Java` 开发工具包，支持包括微信支付、开放平台、公众号、企业微信、视频号、小程序等微信功能模块的后端开发。
### 特别赞助
- <a href="https://www.jeequan.com/product/jeepay.html"><img height="120" src="https://jeequan.oss-cn-beijing.aliyuncs.com/jeepay/img/wxjava_jeepay.png" alt="计全支付Jeepay,开源支付系统"></a>
- <a href="https://github.crmeb.net/u/wxjava"><img height="120" src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/3492e0cfa08e25955b1b2905.png" alt="CRMEB"></a>
> 赞助商招募中，欢迎联系合作。
### 关注公众号
想获得技术交流群（QQ群/微信群/钉钉群）等信息，请扫码关注 `WxJava` 公众号：
[](https://mp.weixin.qq.com/mp/homepage?__biz=MzI3MzAwMzk4OA==&hid=1&sn=f31af3bf562b116b061c9ab4edf70b61&scene=18#wechat_redirect)
### 目录索引
- [快速开始（3分钟）](#快速开始3分钟)
- [AI 编程智能体 SKILL 安装](#ai-编程智能体-skill-安装)
- [我该选哪个模块？](#我该选哪个模块)
- [Maven 引用方式](#maven-引用方式)
- [最小示例](#最小示例)
- [重要信息](#重要信息)
- [其他说明](#其他说明)
- [版本说明](#版本说明)
- [应用案例](#应用案例)
- [特别赞助](#特别赞助)
- [关注公众号](#关注公众号)
- [贡献者列表](#贡献者列表)
### 快速开始（3分钟）
1. 根据业务场景选择模块（见下方“我该选哪个模块？”）
2. 引入 Maven 依赖并选择对应模块
3. 参考最小示例完成初始化并调用 API
### AI 编程智能体 SKILL 安装
仓库的 [`skills`](https://gitee.com/binary/weixin-java-tools/blob/develop/skills) 目录提供面向 WxJava 用户和贡献者的通用 SKILL，包括模块选择、接入、排障、接口贡献和升级迁移。每个 SKILL 都以 `SKILL.md` 为入口，可用于支持该约定的 AI 编程智能体。
支持远程安装 SKILL 的智能体，可以直接使用自然语言指令安装所需目录。例如：
> 安装 https://github.com/binarywang/WxJava/tree/develop/skills/wxjava-integration-guide 中的技能。
可安装的 SKILL 包括：
- [模块选择](https://github.com/binarywang/WxJava/tree/develop/skills/wxjava-module-selector)
- [接入指南](https://github.com/binarywang/WxJava/tree/develop/skills/wxjava-integration-guide)
- [故障排查](https://github.com/binarywang/WxJava/tree/develop/skills/wxjava-troubleshooter)
- [接口贡献](https://github.com/binarywang/WxJava/tree/develop/skills/wxjava-api-contributor)
- [升级迁移](https://github.com/binarywang/WxJava/tree/develop/skills/wxjava-upgrade-guide)
不支持远程安装时，可将所需的 `skills/wxjava-*` 目录复制到智能体的 SKILL 目录或工作区配置目录；不同智能体的目录和启用方式请以其官方文档为准。
以 Codex 为例，可复制到个人 SKILL 目录：
```shell
git clone https://github.com/binarywang/WxJava.git
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R WxJava/skills/wxjava-* "${CODEX_HOME:-$HOME/.codex}/skills/"
```
如果已在本仓库根目录，可直接执行：
```shell
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R skills/wxjava-* "${CODEX_HOME:-$HOME/.codex}/skills/"
```
重启或新建智能体会话后，即可按需使用。例如：`使用 wxjava-integration-guide 为我的 Spring Boot 项目接入微信支付。`
### 我该选哪个模块？
| 业务场景 | 模块 | artifactId |
|---|---|---|
| 微信公众号开发 | MP | `weixin-java-mp` |
| 微信小程序开发 | MiniApp | `weixin-java-miniapp` |
| 微信支付 | Pay | `weixin-java-pay` |
| 企业微信 | CP | `weixin-java-cp` |
| 微信开放平台（第三方平台） | Open | `weixin-java-open` |
| 视频号 / 微信小店 | Channel | `weixin-java-channel` |
> 移动端（iOS/Android）微信登录、分享等能力仍需集成微信官方客户端 SDK；本项目为服务端 SDK。
### 重要信息
1. [`WxJava` 荣获 `GitCode` 2024年度十大开源社区奖项](https://mp.weixin.qq.com/s/wM_UlMsDm3IZ1CPPDvcvQw)。
2. 项目合作洽谈请联系微信`binary0000`（在微信里自行搜索并添加好友，请注明来意，如有关于SDK问题需讨论请参考下文入群讨论，不要加此微信）。
3. **2026-01-03 发布 [【4.8.0正式版】](https://mp.weixin.qq.com/s/mJoFtGc25pXCn3uZRh6Q-w)**！
5. 贡献源码可以参考视频：[【贡献源码全过程（上集）】](https://mp.weixin.qq.com/s/3xUZSATWwHR_gZZm207h7Q)、[【贡献源码全过程（下集）】](https://mp.weixin.qq.com/s/nyzJwVVoYSJ4hSbwyvTx9A) ，友情提供：[程序员小山与Bug](https://space.bilibili.com/473631007)
6. 新手重要提示：本项目仅是一个SDK开发工具包，未提供Web实现，建议使用 `maven` 或 `gradle` 引用本项目即可使用本SDK提供的各种功能，详情可参考 **[【Demo项目】](https://gitee.com/binary/weixin-java-tools/blob/develop/demo.md)** 或本项目中的部分单元测试代码；
7. 微信开发新手请务必阅读【开发文档】（[Gitee Wiki](https://gitee.com/binary/weixin-java-tools/wikis/Home) 或者 [Github Wiki](https://github.com/binarywang/WxJava/wiki)）的常见问题部分，可以少走很多弯路，节省不少时间。
8. 技术交流群：想获得QQ群/微信群/钉钉企业群等信息的同学，请使用微信扫描上面的微信公众号二维码关注 `WxJava` 后点击相关菜单即可获取加入方式，同时也可以在微信中搜索 `weixin-java-tools` 或 `WxJava` 后选择正确的公众号进行关注，该公众号会及时通知SDK相关更新信息，并不定期分享微信Java开发相关技术知识；
9. 钉钉技术交流群：`32206329`（技术交流2群）, `30294972`（技术交流1群，目前已满），`35724728`（通知群，实时通知Github项目变更记录）。
10. 微信开发新手或者Java开发新手在群内提问或新开Issue提问前，请先阅读[【提问的智慧】](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md)，并确保已查阅过 [【开发文档Wiki】](https://github.com/binarywang/WxJava/wiki) ，避免浪费大家的宝贵时间；
11. 寻求帮助时需贴代码或大长串异常信息的，请利用 http://paste.ubuntu.com
--------------------------------
### 其他说明
1. **阅读源码的同学请注意，本SDK为