微信公众号平台Url Token EncodingAESKey 注意点
最近公司让我开发微信公众号平台扫码登录，同步用户信息于PC端，所做的过程当中遇到了一些坑，做完了就总结一下需要注意的点，如若大家开发过程中遇到同样的问题，可以借鉴！
第一：配置域名
作用：配置域名为了在微信的开发过程中，让微信服务器可以通过域名映射到调用你的服务器接口，进行后续的逻辑处理！
配置步骤：设置 --> 公众号设置 --> 功能设置 --> 网页授权设置 (设置你自己的域名即可)
注意：（1）根据微信官网描述，看到 MP_verify_HAlZDt72bkvxIrb6.txt 这个文件，需要下载下来放到你的根目录Webapp下，启动你的服务器。此时，微信服务器会自动的根据你所配置的域名 dcm.xxxxxx.cc/MP_verify_HAlZDt72bkvxIrb6.txt 访问这个文件，并成功读取到该文件中的内容就意味着配置成功！
（2）要是提示失败，有可能是你的服务器中配置了权限拦截，例如：登录权限
第二：配置微信服务器访问你接口的URL Token EncodingAESKey
作用：URL是开发者用来接收微信消息和事件的接口URL。Token可以由开发者任意填写，用作生成签名（该Token会配置在服务器中和接口URL中包含的Token进行比对，从而验证安全性）。EncodingAESKey由开发者手动填写或随机生成，将用作消息体加解密密钥。
配置步骤：开发 --> 基本设置 （填写URL Token EncodingAESKey）
注意（重中之重）：Token EncodingAESKey 需要配置在你的服务器中 WxMpService 的 Config 中，此时还需要编写微信服务访问你接口的代码，返回微信服务器需要返回的结果才会提交成功（这一块的坑我遇到了好多：Token验证失效，URL超时之类，基本问题都是点击提交按钮，微信会自动访问你配置的接口不能返回微信所需要的结果）
例如：配置的域名为：dcm.xxxxxx.cc/mp/login/notify
@Controller
@RequestMapping("/mp/login")
public class ValidateWeiXin extends HttpServlet {
private static final long serialVersionUID = 1L;
private String TOKEN = "这里随便填入32位以内的数字英文，也就是token";
@RequestMapping("/notify")
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType("text/plain;charset=utf-8");
// 微信加密签名
String signature = request.getParameter("signature");
// 随机字符串
String echostr = request.getParameter("echostr");
// 时间戳
String timestamp = request.getParameter("timestamp");
// 随机数
String nonce = request.getParameter("nonce");
String[] str = { TOKEN, timestamp, nonce };
Arrays.sort(str); // 字典序排序
String bigStr = str[0] + str[1] + str[2];
// SHA1加密，我这里用的是common-codec的jar包，你们也可以用java自带的消息消息摘要来写，只不过要多写几行代码，但结果都一样的
DigestUtils.sha1Hex(bigStr);
String digest = DigestUtils.sha1Hex(bigStr);
// 确认请求来至微信
if (digest.equals(signature)) {
response.getWriter().print(echostr);
}
}
}
将这段代码写入你配置微信服务器访问的接口中，就可以提交成功了，后续需要重构这个接口中的代码，例如接收：微信扫码通知、关注通知、取消关注通知、接收发送消息等业务逻辑处理！
第三：微信扫码登录
（1）选用第三方SDK包：https://github.com/Wechat-Group/WxJava （个人认为这个SDK第三方Jar包涵盖了微信不同开发平台的所有功能，封装的很好，推荐使用）可以查看一下具体封装的特点和使用方式，可以提高开发效率！
（2）参考微信官方文档：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1445241432
（3）需要详细阅读 【微信公众平台 --> 消息管理 --> 接收事件推送】 文档，借助第三方SDK工具包进行开发
（4）关注、取消公众号，微信会自动访问你配置的URL接口，根据接收的事件类型，处理不同的业务逻辑
用户未关注时，进行关注后的事件推送 <xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[subscribe]]></Event> <EventKey><![CDATA[qrscene_123123]]></EventKey> <Ticket><![CDATA[TICKET]]></Ticket> </xml> 用户已关注时的事件推送（已经关注了，又扫码登录） <xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[SCAN]]></Event> <EventKey><![CDATA[SCENE_VALUE]]></EventKey> <Ticket><![CDATA[TICKET]]></Ticket> </xml>
自己编写的一段扫码通知、关注、取消关注的Controller代码，可以借鉴一下：
@RequestMapping("/notify")
public String wxnotify(HttpServletRequest request, HttpServletResponse response) {
log.info("【微信通知】wxnotify 接收到请求!");
String message = "success";
try {
request.setCharacterEncoding("UTF-8");
response.setCharacterEncoding("UTF-8");
//把微信返回的xml信息转义成map
Map<String, String> map = XmlUtil.xmlToMap(request);
String fromUserName = map.get("FromUserName"); //消息来源用户标识
String toUserName = map.get("ToUserName"); //消息目的用户标识
String msgType = map.get("MsgType"); //消息类型
String eventType = map.get("Event");
String eventKey = map.get("EventKey");
log.info("【微信通知】fromUserName = {}, toUserName = {}, msgType = {}, eventType = {}, eventKey={}", fromUserName, toUserName, msgType, eventType, eventKey);
if (WxConsts.XmlMsgType.EVENT.equals(msgType)) { //如果为事件类型
if (WxConsts.EventType.SCAN.equals(eventType)) { //扫码通知
if (StringUtils.isNotEmpty(eventKey)) {
log.info("【扫码通知】mid = {}", eventKey);
mpReceiveMessageService.scanQrCodeNotify(fromUserName, eventKey, redisTemplate);
}
} else if (WxConsts.EventType.SUBSCRIBE.equals(eventType)) { //关注通知
if (StringUtils.isNotEmpty(eventKey)) {
String[] paramArray = eventKey.split("_");
String mid = paramArray[1];
log.info("【关注通知】mid = {}", mid);
mpReceiveMessageService.subscribleNotify(fromUserName, mid, redisTemplate);
message = MessageUtil.subscribeForText(toUserName, fromUserName);
}
} else if (WxConsts.EventType.UNSUBSCRIBE.equals(eventType)) {//取消关注通知
log.info("【取消关注通知】");
mpReceiveMessageService.unsubscribleNotify(fromUserName, redisTemplate);
}
}
} catch (Exception e) {
log.error("【微信通知】异常, message = {}", e.getMessage());
}
return message;
}
如有问题，可以一起讨论，相互学习，我也是刚刚接触，需要后续继续努力！
