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

微信小程序所访问的接口路径需是合法域名且必须为 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

三、总结

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


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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,845评论 18 139
  • 用两张图告诉你,为什么你的 App 会卡顿? - Android - 掘金 Cover 有什么料? 从这篇文章中你...
    hw1212阅读 12,854评论 2 59
  • 转载链接 注:本文转载知乎上的回答 作者:初雪 链接:https://www.zhihu.com/question...
    pengshuangta阅读 28,668评论 9 295
  • 今天小编要给大家分享的是搜索引擎优化(SEO)和长期收益。搜索引擎优化是获得长期收益的最佳营销策略。 一、SEO结...
    水墨柒阅读 306评论 0 1
  • 当看完《霸王别姬》之后,再看陈凯歌导演的很多影片,都会觉得他的导演才华已经在那一部作品里用完了,但他用这部《妖猫传...
    麻婆电影阅读 268评论 0 0