美文网首页程序员菲麦前端刻意练习
如何本地调试微信小程序接口服务器

如何本地调试微信小程序接口服务器

作者: 小虫巨蟹 | 来源:发表于2018-12-06 15:21 被阅读40次

    微信小程序所访问的接口路径需是合法域名且必须为 Https 协议,如果你作为微信小程序的接口服务器开发者,并且很不幸的接到了一个服务端异常(500)的反馈,你会如何调试?

    一、束手束脚的服务端调试

    若是浏览器端开发,还可以通过修改访问域名,直接连接到本机 Ip,通过本地调试环境,舒适的查找问题。但是由于小程序的限制,直连 Ip 已然无用。此时一个低效但是有效的定位问题的路径为:

    1. 通过完善的服务器日志体系,寻找突破口(完善的日志体系,就比较重要了)
    2. 检查代码,寻找潜在的问题原因
    3. 修改代码(或许会增加一些日志),编译、部署
    4. Debug 模式重启解析了合法域名,且支持 Https 协议的测试服务器,验证问题
    5. 问题解决,大吉大利吃鸡;否则,重复...

    运气好的话,花上个一天半天的,问题也就解决了

    二、尝试直连本地的调试环境

    不难发现,问题的本质在于两点:

    1. 小程序的接口路径,必须是合法的域名,不能是 Ip 地址
    2. 小程序的接口路径,必须是 Https 协议

    第一个灰常简单,修改 hosts,将 127.0.0.1 绑定到 xxx.xxx.com 上,这里推荐一个工具,SwitchHosts!,Mac 和 Windows 都有,别再傻傻的手动改 host 文件了


    SwitchHosts!

    第二个问题就到了展示真正的技术的时候了(本来支持 Https 协议也不算什么难事,只是很多时候,这部分都轮不到开发同学解决,所以还是有一定的实操难度),这里以 Node 为例:

    if (envConfig.nodeEnv === 'wechat') {
      https_options = {
        key: fs.readFileSync('./.ssl/private.pem'), // 域名证书私钥
        cert: fs.readFileSync('./.ssl/file.crt') // 域名证书公钥
      };
      http.createServer(require('redirect-https')()).listen(envConfig.httpPort, () => {
        logger.info(`HTTP server is now running on port: ${envConfig.httpPort}`);
      });
    
      // 通过 https 模块启动
      https.createServer(https_options, app).listen(envConfig.httpsPort, () => {
        logger.info(`HTTPS server is now running on port: ${envConfig.httpsPort}`);
      });
    } 
    

    要点:

    1. 区分 “wechat” 环境启动是因为,运维同学,早就把服务器 Https 的访问给搞定了啦,就不要在你的破代码里重复搞了
    2. 要拿到域名的SSL证书,这里的方式就很多样了,可以用 Let's Encrypt 免费的慢慢搞,但是最简单最简单的方式就是直接到阿里云去买一个免费(买,免费!!!)为期一年的 SSL 证书,像这样的:

      这个详细步骤上篇文章,阿里云攻略之——Http to Https 已经有说明,可以移步过去瞅瞅
    3. 基于 Node https 模块启动服务,Over

    三、总结

    后来我把文章发出去之后,收到了评论:


    妈个唧唧,我知道的太多了~~

    相关文章

      网友评论

        本文标题:如何本地调试微信小程序接口服务器

        本文链接:https://www.haomeiwen.com/subject/qvkocqtx.html