Home

各模块开发文档

1. 微信公众号(mp) （包含网页授权、网站登录等相关接口）
2. 企业微信(cp)
3. 微信支付(pay)
4. 微信开放平台(open)
5. 微信小程序(miniapp)

重要信息

之前使用老版本，升级新版本的同学请注意，为规范代码， 部分代码做了重构，命名发生变化，具体如下：

1. WxMpInMemoryConfigStorage => WxMpDefaultConfigImpl；
2. WxCpInMemoryConfigStorage => WxCpDefaultConfigImpl；
3. WxCpJedisConfigStorage => WxCpRedisConfigImpl；
4. WxCpTpInMemoryConfigStorage => WxCpTpDefaultConfigImpl；
5. WxMaInMemoryConfig => WxMaDefaultConfigImpl；
6. WxMaInRedisConfig => WxMaRedisConfigImpl；
7. WxMpInRedisConfigStorage => WxMpRedisConfigImpl
8. WxMpOAuth2AccessToken => WxOAuth2AccessToken

常见异常问题的解决办法

1. 加解密时出现Illegal key size异常的处理办法
2. 发生java.security.KeyException的解决办法
3. 出现NoClassDefFoundError、NoSuchFieldError、NoSuchMethdError或ClassNotFoundException的解决办法
4. 升级 commons-codec 至 1.13 版本后,加解密时出现 java.lang.IllegalArgumentException: Last encoded character (before the paddings if any) is a valid base 64 alphabet but not a possible value. Expected the discarded bits to be zero. 异常的解决办法
5. org.xml.sax.SAXNotRecognizedException: unrecognized feature
6. 小程序解密有关信息时出现JsonSyntaxException异常时请参考这里，或者查看官方文档相关说明，或者https://www.cnblogs.com/guansixu/articles/6484872.html
7. 微信小程序更新wx.getUserProfile，无法获取到小程序用户信息
8. 微信小程序支持多账号的解决办法，其他项目支持多账号同理
9. 企业微信集群部署，accessToken失效解决方案：共享accessToken到redis，其他同理，或者请参考这里

其他常见问题

1. 在微信后台设置安全域名时，注意不要将http等字符带入，首先要理解域名的含义，应该是www.abcde.com类似这样的
2. WxConsts常用常量定义
3. Http框架的选用说明
4. HttpClient参数配置（寻找超时等相关参数设置方法的，请点击进入）
5. 对Maven不熟的，建议学习此视频
6. 几个内网端口映射（穿透）服务网站(可以实现将内网服务暴露给外网访问)
7. 下载maven jar包出现问题时请设置maven镜像库
8. Emoji表情字符存储有问题，或者遇到保存字符串到数据库里出现\xF0\x9F\x92\x94类似问题时，请尝试使用这个工具，或者自行修改数据库存储编码为utf8mb4
9. httpclient 4.3.1 版本有bug，请不要使用
10. Session
11. 配置日志
12. 消息排重

---

后记：没错！正如你所发现的，该文档可以随便编辑，但请手下留情，不要作恶，只修改或添加你认为有用的东西，任何修改都留有记录！请谨慎修改！！！