【胎教级】微信公众号开发配置
这篇文章可以帮你打通微信公众号开发任督二脉。
一、JS域名验证
入口在公众号后台:设置与开发 - 公众号设置 - 功能设置 - JS接口安全域名
界面会提示需把一个校验文件上传到域名目录下
实际场景中,我们可能有很多个公众号和很多个服务,所以我们可以把文件统一放到一个目录下,如:/data/wechat_verify
我使用了宝塔,可视化界面操作,上传完成
然后修改nginx配置,比如我想要通过 https://weijunext.com/MP_verify_xxxxxxx.txt 访问这个校验文件,我就需要在原有的配置下添加这个文件的路径配置
修改完nginx配置,重启一下才会生效
在公众号后台,把【JS接口安全域名】、【业务域名】和【网页授权域名】都配置上
二、开发信息配置
入口在公众号后台:设置与开发 - 基本配置 - 公众号开发信息
复制appid、appsecret并妥善保存;设置IP白名单,就是我们要部署服务的那台服务器的IP
三、服务器配置
在实际业务开发中,我们可能需要接受微信的消息推送(如:用户关注、用户取消关注等),这就需要我们配置自己服务器、并且提供对应接口给微信。入口在公众号后台:设置与开发 - 基本配置 - 服务器配置。
这一步一定要写好接口部署后再提交配置,否则微信调我们服务出现错误,就会当作校验错误了。
为了以防万一,我们需要用测试账号在本地调试。测试账号入口:设置与开发 - 开发者工具 - 公众平台测试账号。
根据微信开放文档:我们知道验证服务器需要先给微信提供一个 Get 接口,直接上代码
第一步:写一个 Get 接口
第二步:解密方法
接口准备好了之后,就可以去填写配置了。但是,现在是在本地开发,我们得想办法让微信调用到本地的服务,这时候就需要内网穿透工具来帮助我们了。
我使用的穿透工具是localtunnel,使用方法很简单:
代理成功后就会看到代理的url,这就是我们要使用的服务器地址了
注1:如果输入命令没有反应,那么就是需要科学上网
注2:这是一个临时url,如果发现无法使用了,重新执行启动命令,获取一个新的url就可以
有了接口和穿透,现在配置一下 URL 和 Token,就能成功了
这样就说明我们本地服务和微信测试账号打通了,可以开始开发业务接口了。
注:本地打通后,把代码更新到服务器上,再按相同的步骤去配置公众号后台正式环境的信息就可以。如果公众号后台正式环境无法配置成功,问题肯定不在你的服务代码中,请排查nginx、服务器等环境。
四、调试微信消息推送
上一步我们写一个 Get 接口,后台也配置了一个 URL,但是根据文档,我们可以知道,微信消息推送也是往我们配置的 URL 发送,但是是 Post 方法,所以我们只需要提供一个同名的 Post 方法来接收就可以了。
拿起你的手机,关注配置页的测试账号
然后给账号发一条消息,就可以收到代码里写的回复了
至此配置和本地调试打通,可以开始开发正式的业务逻辑了。
结语
要做微信开发,繁琐的配置和本地调试总是会耗费很多时间精力,特此写一篇文章记录配置和调试步骤,我称之为“打通微信公众号开发任督二脉”,打通后就是大家熟悉的业务开发了,希望这篇文章对大家有用。