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

 

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

三、总结

后来我把文章发出去之后，收到了评论：

 

 

挖码笔记