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

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

三、总结

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


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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,390评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,821评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,632评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,170评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,033评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,098评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,511评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,204评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,479评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,572评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,341评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,213评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,576评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,893评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,171评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,486评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,676评论 2 335

推荐阅读更多精彩内容

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