微信公众号开发,实现本地开发调试
微信用户每次向公众号发起请求时,微信服务器会先接收到用户的请求,然后再转发到我们的服务器上,也就是说,微信服务器是要和我们的服务器进行网络交互,所以我们必须保证我们的服务器外网可以访问到,这种部署到公网服务器进行测试的做法对于我们开发者来说非常不方便,没法debug查看每一步代码的运行情况,解决办法就是将内网的部署服务器映射到外网,让微信服务器可以正常访问到。三、需要注意的是,我们申请的是正式使用
一、申请一个微信测试公众号
1.1 要在微信公众号上挂载应用,首先自己得需要一个公众号测试用,所以需要去微信公众平台上申请一个,我们个人的话只能申请订阅号。
1.2 这边申请一个订阅号。
1.3填写基本信息,需要注意的是需要一个未激活过微信公号的邮箱,然后点击注册。
这里会在所填邮箱中收到一个验证码。
1.4 选择类型,中国大陆即可。
1.5 下一步选择订阅号。
1.6 下一步填写信息,这里选择个人,按找要求填写各个信息。
1.7 最后注册成功。
二、填写服务器配置
2.1 选择 开发–基本配置(第一次点开可能会出现需要成为开发者,审核后才会出现下图页面。)
2.2 接下来配置服务器。为了能和我们自己的服务通信,我们需要在接口配置信息中填写URL和Token和我们的服务建立连接。需要注意的是需要在我们自己服务中接收微信公众号传输的信息并且给出回应,不然会提示验证失败。第二点是这里的URL只对公网有效,对我们本地项目启动的IP是无效的,因此需要把我们的服务挂在一台有公网IP的服务器上,才能建立通信,我自己这边是通过内网穿透实现的,因为使用内网穿透的优点是可以在本地调试。(URL分成两部分,第一部分为公网IP,第二部分为接口路径,该接口是为了接收参数并给出回应)
2.4 开发基于微信公众号的应用最大就是调试问题,每次测试都需要部署到公网服务器进行测试。微信用户每次向公众号发起请求时,微信服务器会先接收到用户的请求,然后再转发到我们的服务器上,也就是说,微信服务器是要和我们的服务器进行网络交互,所以我们必须保证我们的服务器外网可以访问到,这种部署到公网服务器进行测试的做法对于我们开发者来说非常不方便,没法debug查看每一步代码的运行情况,解决办法就是将内网的部署服务器映射到外网,让微信服务器可以正常访问到。下面推荐一个我自己免费实现内网穿透的方法。通过natapp进入natapp官网NATAPP-内网穿透 基于ngrok的国内高速内网映射工具
进入官网主要目的是获取token,首先先下载客户端。
然后注册账号:
然后购买一个免费隧道:
然后在本地环境变量中配置path,路径就是第一步下载客户端解压后的位置:
接着双击下载解压后的natapp.exe,输入以下命令:
natapp -authtoken yourtoken
回车后会出现
外网访问上边Forwarding后边的那个地址,就能访问到我们本地的地址了。
需要注意的是:隧道上配置的端口需要和本地项目启动的端口一致!
隧道端口:
本地端口:
至此内网穿透成功,公网地址就填Forwarding后边的那个地址就可以了。
最后一步,需要在URL所写的接口中写一段代码来响应微信服务器,token需要和配置中的一致,这样才能配置成功。下面代码仅供参考:
package cn.e4j.modular.api.controller;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Arrays;
/**
* 2023/11/13
*
* @author XiaoYu
* @version 1.0.0
*/
@RequestMapping("connect")
@Controller
public class test {
//切记:这里是自定义的token,需和你微信配置界面提交的token完全一致
private final String TOKEN = "LongGeTest";
static Logger logger = LoggerFactory.getLogger(test.class);
@RequestMapping("test")
public void checkSignature(HttpServletRequest request, HttpServletResponse response) {
System.out.println("校验签名start");
/**
* 接收微信服务器发送请求时传递过来的参数
*/
//签名
String signature = request.getParameter("signature");
//时间戳
String timestamp = request.getParameter("timestamp");
//随机数
String nonce = request.getParameter("nonce");
//随机字符串
String echostr = request.getParameter("echostr");
/**
* 将token、timestamp、nonce三个参数进行字典序排序
* 并拼接为一个字符串
*/
String sortStr = this.sort(TOKEN,timestamp,nonce);
/**
* 对排序后的sortStr进行shal加密
*/
String mySignature = shal(sortStr);
/**
* 校验"微信服务器传递过来的签名"和"加密后的字符串"是否一致, 如果一致则签名通过,否则不通过
*/
if(!"".equals(signature) && !"".equals(mySignature) && signature.equals(mySignature)){
System.out.println("校验结果:"+"签名校验通过");
try {
//必须响应给微信,不然会提示"token校验失败"
response.getWriter().write(echostr);
} catch (IOException e) {
e.printStackTrace();
}
}else {
System.out.println("校验结果:"+"校验签名失败");
}
}
/**
* 参数排序
* @param token
* @param timestamp
* @param nonce
* @return
*/
public String sort(String token, String timestamp, String nonce) {
String[] strArray = {token, timestamp, nonce};
Arrays.sort(strArray);
StringBuilder sb = new StringBuilder();
for (String str : strArray) {
sb.append(str);
}
return sb.toString();
}
/**
* 字符串进行shal加密
* @param str
* @return
*/
public String shal(String str){
try {
MessageDigest digest = MessageDigest.getInstance("SHA-1");
digest.update(str.getBytes());
byte messageDigest[] = digest.digest();
StringBuffer hexString = new StringBuffer();
// 字节数组转换为 十六进制 数
for (int i = 0; i < messageDigest.length; i++) {
String shaHex = Integer.toHexString(messageDigest[i] & 0xFF);
if (shaHex.length() < 2) {
hexString.append(0);
}
hexString.append(shaHex);
}
return hexString.toString();
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
}
return "";
}
}
然后启动项目后,点击提交。(如果提交成功,说明通信完成)。
三、需要注意的是,我们申请的是正式使用的公众号,它提供的接口权限很少,所以微信平台专门为开发者提供了一个微信公众测试号来方便我们测试更全面的接口。
3.1 所以我们可以申请一个微信公众测试账号。在开发者工具中申请公众平台测试账号。
3.2 进入公众平台测试账号页面,可以看到appID、appsecret等参数,这些都是后面我们调用微信公众号接口所需要给的参数。
3.3 在接口配置信息中填写和上面配置一样的参数,点击提交。
这边需要注意的是,只有在正式公众号中服务器配置成功后,测试号才能配置成功!!
至此我们就可以根据微信公众号提供的接口文档去开发公众号啦!
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)