微信公众号开发需要准备的一些资料以及如何搭建一个本地测试服务环境

雨点打透心脏的1/2处 2022-04-17 00:39 199阅读 0赞

一、账号准备

申请一个微信号（下载微信客户端，手机注册，或是qq注册）

申请一个微信公众号 （[去申请][Link 1]），申请什么样的微信公众号，请参照 [微信详细注册步骤][Link 2]。

申请一个微信公众平台接口测试帐号 （[去申请][Link 3]）

二、服务器准备

因为微信公众号只能连接到外网地址，是不能直接访问到本地localhost的项目地址进行测试的。

1.方式一：买的云主机。推荐 [爱名网][Link 4]

2.方式二：BAE（注册百度账号，然后登录 [百度云开发 ][Link 5]）

3.方式三：SAE（注册新浪微博，然后登录SAE ,点击注册「[新浪云福利][Link 6]」现在还有1000云豆免费领！一起来用吧！）  比较推荐的方式。

4.方式四：  购买花生壳这种本地映射外网的工具。通过这样的工具方便我们在本地进行调试。（推荐） 具体文章请参考：[如何架设本地web 服务器来调试自己的微信公众号服务][web]

5.方式五：可以通过免费映射工具。比如：

（1）natapp  官网 ：https://natapp.cn/

（2）ngrok 官网：https://www.ngrok.cc/

（3）nat123 官网：http://www.nat123.com/等;

大家看自己情况进行选择，如何配置动态域名请自行百度。

本人采用的是免费的映射工具natapp 来搭建的。

首先获取到了动态域名：[http://gb4xrs.natappfree.cc][http_gb4xrs.natappfree.cc]，然后去你申请的微信测试号进行域名配置。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl8zOTIyMDQ3Mg_size_16_color_FFFFFF_t_70][]

注url就是域名+项目名+访问路径，token就是你项目后台要检验的参数，然后提交，显示配置成功则表明你的本地测试环境搭建成功了。

比如我的url是：[http://gb4xrs.natappfree.cc/appointment/wechat/toAppoin][http_gb4xrs.natappfree.cc_appointment_wechat_toAppoin]（项目采用的是ssm框架：spring+springmvc+mybatis）

（域名：[http://gb4xrs.natappfree.cc][http_gb4xrs.natappfree.cc]，项目名：appointment，控制层访问路径：/wechat/toAppoin）

控制层验证代码：

/**
     * 微信公众号控制器
     *
     */
    @Controller
    @RequestMapping("/wechat")
    public class WechatController implements IWechatController {
    	Logger log=LoggerFactory.getLogger(WechatController.class);
    	
    	@Autowired
    	private IAppointmentRecordService appointmentRecordService;
    	@Autowired
    	private IWechatService wechatService;
    	
    	/**
    	 * 验证微信
    	 * @param request
    	 * @param response
    	 * @throws IOException
    	 */
    	@RequestMapping(value = "/toAppoin", method = RequestMethod.GET)
    	public void wechat(HttpServletRequest request, HttpServletResponse response) 
    			 throws IOException { 
    			 System.out.println("接口测试开始！！！"); 
    			 //微信加密签名 
    			 String signature = request.getParameter("signature"); 
    			 //时间戳 
    			 String timestamp = request.getParameter("timestamp"); 
    			 //随机数 
    			 String nonce = request.getParameter("nonce"); 
    			 //随机字符串 
    			 String echostr = request.getParameter("echostr"); 
    			  
    			 PrintWriter out = response.getWriter(); 
    			 //通过校验signature对请求进行校验，若校验成功则原样返回echostr，表示接入成功，否则接入失败 
    			 if(CheckoutUtil.checkSignature(signature,timestamp,nonce)){ 
    				 System.out.println("cs----------"+echostr);
    			        out.print(echostr); 
    			 } 
    			 out.close(); 
    			 out = null; 
    			  
    			  
    			 } 
    	
    	}

**  验证代码：**

import java.security.MessageDigest;
    import java.security.NoSuchAlgorithmException;
    
    public class CheckoutUtil {
        // 与接口配置信息中的Token要一致
        private static String token = "cxh123";
    
    
        /**
         * 验证签名
         * 
         * @param signature
         * @param timestamp
         * @param nonce
         * @return
         */
        public static boolean checkSignature(String signature, String timestamp, String nonce) {
            String[] arr = new String[] { token, timestamp, nonce };
            // 将token、timestamp、nonce三个参数进行字典序排序
            // Arrays.sort(arr);
            sort(arr);
            StringBuilder content = new StringBuilder();
            for (int i = 0; i < arr.length; i++) {
                content.append(arr[i]);
            }
            MessageDigest md = null;
            String tmpStr = null;
    
    
            try {
                md = MessageDigest.getInstance("SHA-1");
                // 将三个参数字符串拼接成一个字符串进行sha1加密
                byte[] digest = md.digest(content.toString().getBytes());
                tmpStr = byteToStr(digest);
            } catch (NoSuchAlgorithmException e) {
                e.printStackTrace();
            }
            content = null;
            // 将sha1加密后的字符串可与signature对比，标识该请求来源于微信
            return tmpStr != null ? tmpStr.equals(signature.toUpperCase()) : false;
        }
    
    
        /**
         * 将字节数组转换为十六进制字符串
         * 
         * @param byteArray
         * @return
         */
        private static String byteToStr(byte[] byteArray) {
            String strDigest = "";
            for (int i = 0; i < byteArray.length; i++) {
                strDigest += byteToHexStr(byteArray[i]);
            }
            return strDigest;
        }
    
    
        /**
         * 将字节转换为十六进制字符串
         * 
         * @param mByte
         * @return
         */
        private static String byteToHexStr(byte mByte) {
            char[] Digit = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' };
            char[] tempArr = new char[2];
            tempArr[0] = Digit[(mByte >>> 4) & 0X0F];
            tempArr[1] = Digit[mByte & 0X0F];
            String s = new String(tempArr);
            return s;
        }
        public static void sort(String a[]) {
            for (int i = 0; i < a.length - 1; i++) {
                for (int j = i + 1; j < a.length; j++) {
                    if (a[j].compareTo(a[i]) < 0) {
                        String temp = a[i];
                        a[i] = a[j];
                        a[j] = temp;
                    }
                }
            }
        }
    }

代码写好了，这是在微信测试公众号点击提交，便会显示配置成功。

配置成功后：如果url验证访问地址或者域名有改动，那就重新配置。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl8zOTIyMDQ3Mg_size_16_color_FFFFFF_t_70 1][]

如果显示配置失败：1.请检查你的域名是否有效，2.请检查你的url能否映射到你本地的项目，检查方法就是浏览器直接打开你的url地址，你可以在后台代码中输出“进入验证”等的信息输出在控制台上来测试。

### 我的座右铭：不会，我可以学；落后，我可以追赶；跌倒，我可以站起来；我一定行。 ###

[Link 1]: https://mp.weixin.qq.com/cgi-bin/loginpage?t=wxm2-login&lang=zh_CN
[Link 2]: http://kf.qq.com/faq/120911VrYVrA130620u2iA7n.html
[Link 3]: http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
[Link 4]: http://www.22.cn/s/679395
[Link 5]: http://login.bce.baidu.com/
[Link 6]: http://t.cn/RcHY6zM
[web]: http://www.souvc.com/?p=2272
[http_gb4xrs.natappfree.cc]: http://gb4xrs.natappfree.cc
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl8zOTIyMDQ3Mg_size_16_color_FFFFFF_t_70]: /images/20220417/5cbd0a4139e944cd86face2376f8a1e0.png
[http_gb4xrs.natappfree.cc_appointment_wechat_toAppoin]: http://gb4xrs.natappfree.cc/appointment/wechat/toAppoin
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl8zOTIyMDQ3Mg_size_16_color_FFFFFF_t_70 1]: /images/20220417/eb36eced35634e8085f5b2ad6bbfed66.png