微信开发（一）搭建开发环境

Dear 丶 2022-05-25 01:38 309阅读 0赞

# 说明 #

公司需要开发微信服务号，要求做有关技术验证，学习了微信公众号的开发，在这里记录总结下。

# 正文 #

学习微信公众号的开发，必须先阅读微信开发文档，通过阅读文档，了解有关微信公众开发的步骤及相关限制，了解其工作原理等。

[微信开发之入门指引][Link 1]

通过阅读入门指引，发现在正式开发之前必须要具备几个条件：1.申请微信公众号 2. 后台服务器 3.开发者配置

## 申请测试公众号 ##

在微信官网申请公众号时，发现目前公众号只有两类帐号：服务号和订阅号，个人只能申请订阅号。原来的企业号变为企业微信，增加了微信小程序。申请地址为：[https://mp.weixin.qq.com/][https_mp.weixin.qq.com]  
![这里写图片描述][20180505145528948]

通过阅读微信文档的公众号接口权限说明，发现未经认证的订阅号接口权限十分有限，无法完成接下来的技术验证。  
![这里写图片描述][20180505145834504]  
这里使用微信提供的在线测试平台，申请一个接口测试号完成有关技术验证。地址：[https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login][https_mp.weixin.qq.com_debug_cgi-bin_sandbox_t_sandbox_login]  
![这里写图片描述][20180505152405639]

使用自己的微信号通过扫码即可申请一个测试号  
![这里写图片描述][20180505152517469]  
微信会自动为测试号分配appID和appsecret，这两个参数是开发的关键。  
测试号申请到这里就结束了，接下来配置服务器。

## 配置本地服务器 ##

阅读微信开发文档时发现，服务器必须外网可以访问且端口为80。要么需要购买云服务器，但这对我们开发调试有很大的不便，这里我使用了内网穿透工具实现外网访问，将本地的tomcat作为后台的应用服务器。  
工具为NATAPP，使用此工具可以自动将它产生的域名映射为本地的ip地址+端口。地址：[https://natapp.cn/][https_natapp.cn]  
![这里写图片描述][20180505154323732]

在下方的客户端下载中选择适合自己电脑的版本  
![这里写图片描述][20180505154447377]

下载成功后需要注册登录申请免费隧道，每个用户可以拥有两条不同协议的隧道，免费隧道域名随机分配且会强制更换，这点在开发时需要注意，需要在微信配置中随时更换URL。  
![这里写图片描述][20180505155217143]

在申请时注意隧道协议为web，且本地端口为80  
![这里写图片描述][2018050515542849]  
申请好会为隧道分配一个authtoken,这个token时让NATAPP可以运行起来的关键，接下来在运行前必须配置文件，关于配置文件的下载地址：[https://natapp.cn/article/config\_ini][https_natapp.cn_article_config_ini] ，更多教程参考：[https://natapp.cn/article/natapp\_newbie][https_natapp.cn_article_natapp_newbie]  
配置文件必须与之前解压的natapp.exe在同一级目录，然后将得到的authtoken填入保存。  
![这里写图片描述][20180505160112520]

运行结果为：  
![这里写图片描述][20180505160328148]  
这里可以看到随机分配的域名指向了本地的80端口。这里的域名就是测试号配置URL需要填写的参数。

关于本地服务器的搭建到这里就结束了，接下来在之前申请的测试号中进行配置。

## 配置测试号 ##

在配置之前必须搭建一个web项目，因为填写配置时微信服务器会向后台进行验证，后台给出正确的响应才会配置成功。这里我使用了SpringBoot构建web项目，关于SpringBoot如何构建web项目，可以在网上查阅相关资料，对于SpringBoot的学习推荐翟永超的博客[程序猿DD][DD]。关于如果将SpringBoot项目部署到本地Tomcat中请参考另一篇博文[《将Spring Boot项目部署到本地Tomcat中》][Spring Boot_Tomcat]

![这里写图片描述][2018050517380762]  
URL即为NATAPP运行时得到的域名，Token随意填写，程序中需要使用。

校验代码：

@RequestMapping(value="hello", method = RequestMethod.GET)
        public void hello(HttpServletRequest request,
                            HttpServletResponse response){
            System.out.println("success");
            String signature = request.getParameter("signature");
            String timestamp = request.getParameter("timestamp");
            String nonce = request.getParameter("nonce");
            String echostr = request.getParameter("echostr");
    
            PrintWriter out = null;
            try {
                out = response.getWriter();
                if(CheckUtil.checkSignature(signature,timestamp, nonce)){
                    out.write(echostr);
                }
            } catch (IOException e) {
                e.printStackTrace();
            } finally {
                out.close();
            }
    
        }

在校验类CheckUtil中对微信服务器传来的参数进行校验

import java.security.MessageDigest;
    import java.util.Arrays;
    
    public class CheckUtil { 
        public static final String tooken = "testdemo";
        public static boolean checkSignature(String singnature, String timestamp, String nonce){
            String[] arr = {tooken, timestamp,nonce};
            Arrays.sort(arr);
            StringBuilder sb = new StringBuilder();
            for(String s : arr){
                sb.append(s);
            }
            String temp = getSha1(sb.toString());
            return temp.equals(singnature);
        }
    
        private static String getSha1(String str){
            if(str==null||str.length()==0){
                return null;
            }
    
            char hexDigits[] = {
       '0','1','2','3','4','5','6','7','8','9',
                    'a','b','c','d','e','f'};
    
            try {
                MessageDigest mdTemp = MessageDigest.getInstance("SHA1");
    
                mdTemp.update(str.getBytes("UTF-8"));
    
                byte[] md = mdTemp.digest();
                int j = md.length;
                char buf[] = new char[j*2];
                int k = 0;
    
                for (int i = 0; i < j; i++) {
                    byte byte0 = md[i];
                    buf[k++] = hexDigits[byte0 >>> 4 & 0xf];
                    buf[k++] = hexDigits[byte0 & 0xf];
                }
    
                return new String(buf);
    
            } catch (Exception e) {
                return null;
    
            }
        }
    }

能正常响应时，就会出现配置成功，接下来就可以进行验证开发了。

[Link 1]: https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1472017492_58YV5
[https_mp.weixin.qq.com]: https://mp.weixin.qq.com/
[20180505145528948]: /images/20220525/2bcd423067554b69b3ca2d3e1dad6409.png
[20180505145834504]: /images/20220525/c7dfb3cad33d47c0ba095b5bc85b5394.png
[https_mp.weixin.qq.com_debug_cgi-bin_sandbox_t_sandbox_login]: https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
[20180505152405639]: /images/20220525/614881aa93384e999267384cf4fb6615.png
[20180505152517469]: /images/20220525/041c92370f26447ebb9ba812465dd357.png
[https_natapp.cn]: https://natapp.cn/
[20180505154323732]: /images/20220525/830d50cd52124bef96bf32cf5862e1bc.png
[20180505154447377]: /images/20220525/fa435d70af354db0a44dbdb05c028e3c.png
[20180505155217143]: /images/20220525/15959f66b74e4bf3a86f58f10e6f1ee0.png
[2018050515542849]: /images/20220525/f4132e5104f940d6a7bc41d1eb0989a6.png
[https_natapp.cn_article_config_ini]: https://natapp.cn/article/config_ini
[https_natapp.cn_article_natapp_newbie]: https://natapp.cn/article/natapp_newbie
[20180505160112520]: /images/20220525/f18f3f6bf730445594da48f459690504.png
[20180505160328148]: /images/20220525/b4b93f904df74496bb93b9675b7081a5.png
[DD]: http://blog.didispace.com/aboutme/
[Spring Boot_Tomcat]: https://blog.csdn.net/sinat_36553913/article/details/79900879
[2018050517380762]: /images/20220525/e09a9c65cd8a4df2b9450dd0ab75987f.png