微信小程序所访问的接口路径需是合法域名且必须为 Https 协议,如果你作为微信小程序的接口服务器开发者,并且很不幸的接到了一个服务端异常(500)的反馈,你会如何调试?
一、束手束脚的服务端调试
若是浏览器端开发,还可以通过修改访问域名,直接连接到本机 Ip,通过本地调试环境,舒适的查找问题。但是由于小程序的限制,直连 Ip 已然无用。此时一个低效但是有效的定位问题的路径为:
- 通过完善的服务器日志体系,寻找突破口(完善的日志体系,就比较重要了)
- 检查代码,寻找潜在的问题原因
- 修改代码(或许会增加一些日志),编译、部署
- Debug 模式重启解析了合法域名,且支持 Https 协议的测试服务器,验证问题
- 问题解决,大吉大利吃鸡;否则,重复...
运气好的话,花上个一天半天的,问题也就解决了
二、尝试直连本地的调试环境
不难发现,问题的本质在于两点:
- 小程序的接口路径,必须是合法的域名,不能是 Ip 地址
- 小程序的接口路径,必须是 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}`);
});
}
要点:
- 区分 “wechat” 环境启动是因为,运维同学,早就把服务器 Https 的访问给搞定了啦,就不要在你的破代码里重复搞了
- 要拿到域名的SSL证书,这里的方式就很多样了,可以用 Let's Encrypt 免费的慢慢搞,但是最简单最简单的方式就是直接到阿里云去买一个免费(买,免费!!!)为期一年的 SSL 证书,像这样的:
这个详细步骤上篇文章,阿里云攻略之——Http to Https 已经有说明,可以移步过去瞅瞅 - 基于 Node https 模块启动服务,Over
三、总结
后来我把文章发出去之后,收到了评论:
妈个唧唧,我知道的太多了~~
网友评论