浅谈企业微信中AccessToken管理和API操作

前言

众所周知，在微信公众平台开发中，其实就是一系列的API请求和自身业务系统的集成，而在API请求中，AccessToken是优势一个必不可少的参数。

注：

• 本文基于企业微信，故部分API请求可能和订阅号，服务号，小程序不太相同，但整体思路一致。
• 本项目代码基于Java语言，SpringBoot框架。

在企业微信开发文档中有这样一段：

• access_token的有效期通过返回的expires_in来传达，正常情况下为7200秒（2小时），有效期内重复获取返回相同结果，过期后获取会返回新的access_token。
• 由于企业微信每个应用的access_token是彼此独立的，所以进行缓存时需要区分应用来进行存储。
• access_token至少保留512字节的存储空间。
• 企业微信可能会出于运营需要，提前使access_token失效，开发者应实现access_token失效时重新获取的逻辑。

需要注意的点：

• 在有效期内，重复获取不会返回新的AccessToken，并且不会延长有消息。（即使不在同一个程序内获取）
• AccessToken可能会提前过期。（两个小时获取一次可能会出现提前过期的问题）

问题描述

原始方案： V0.1 定时器（schedule） 描述：在SpringBoot项目中，使用@Scheduled注解，每一小时获取一次AccessToken。 问题：在运行一段时间后，因网络波动导致某次请求失败，程序出错，定时器没有继续执行。 影响：程序无法进行任何微信相关的API请求。 改进：V0.2 定时器+异常捕获 V0.2 定时器+异常捕获 描述：在上述版本的情况下，增加异常捕获。 问题：运行一段时间再次出现异常，程序在获取AccessToken过程中出现阻塞，后续代码均未执行，定时器也无法执行。

改进方案

这里写图片描述

总结：

此方案的优点在于，程序无需通过定时器或线程去处理AccessToken，通过Redis的缓存，并设置过期时间，实现动态的管理，并能和其他程序共享AccessToken（对于多个程序需要使用同一个应用时，会存在此需求）。在过期也能自动获取，并不影响程序正常运行。 即使某次请求出现问题，不会影响之后的请求。

代码展示

图中设计的几个类实现如下：

• WorkWXAPI类： 定义了企业微信相关的API请求的URL地址，以及其他企业微信相关的常量等。

注：代码使用String.format进行占位符替换，使用时需注意参数的顺序，以免因替换出错导致的传参错误。

• WXAPIUtil类 WXAPIUtil为封装的企业微信相关API操作的类，如：获取AccessToken获取，更新，删除用户信息，获取，创建，更新部门信息等。

注:因代码过长，此处只引入部门函数。

• HttpClientUti类 包括Get，Post，wxRequest方法，可执行普通的http请求。

核心方法为：wxRequest

其中StringRedisTemplate在主函数中注入

Controller中调用如下：