微信js-sdk本地调试方案

bolelee

此方案为同事探究得出,现本人即将离职,特此记录下该方案,以备后续查找。

解决的问题

  • 微信js-sdk初始化需要校验域名,本地调试无法通过,需伪装成生产/测试时访问的域名
  • 也适用于抓取手机端的请求,在PC端进行分析(Charles)

方案思路要点

  1. 修改Host, 使得目标域名映射到本机(127.0.0.1)
  2. nginx开启HTTPS server,将目标域名proxy_pass到要测试的项目本地地址(如http://localhost:8080)
  3. 手机通过Charles代理到电脑本机

修改Hosts

sudo vi /etc/hosts

# 添加目标域名映射
127.0.0.1    [target-host-name]

安装nginx

建议通过Homebrew安装

brew install nginx
nginx -v
nginx -h

成功安装截图
image.png

# 成功安装后摘录如下
Docroot is: /usr/local/var/www
The default port has been set in: /usr/local/etc/nginx/nginx.conf to 8080 so that nginx can run without sudo
nginx will load all files in /usr/local/etc/nginx/servers/.

可以修改下默认端口,然后跑nginx启动, 可以在浏览器看到默认的http server,表示nginx安装好了,没什么问题。

mkcert生成ssl证书

要开启https server,需要有ssl证书,使用mkcert可以在本地安装证书。

mkcert: https://github.com/FiloSottil...

生成证书的方式,请通读其README,主要了解安装、生成证书命令、安装CA命令

建议将证书放到nginx安装目录下usr/local/etc/nginx/ssl,命名自行根据实际命名即可。

mkcert -key-file [key.pem] -cert-file [cert.pem] [target-host-name] [target-host-name]

配置https server

...
http {
    ...
    # HTTPS server
    server {
       listen       443 ssl;
       server_name  [target-host-name];
       proxy_buffering off;
       ssl_certificate      /usr/local/etc/nginx/ssl/[cert.pem];
       ssl_certificate_key  /usr/local/etc/nginx/ssl/[key.pem];
       ssl_session_cache    shared:SSL:1m;
       ssl_session_timeout  5m;
       ssl_ciphers  HIGH:!aNULL:!MD5;
       ssl_prefer_server_ciphers  on;
       location / {
           root   html;
           index  index.html index.htm;
           proxy_pass          [本地服务,如 http://localhost:8080];
       }
    }
}

设置完毕重启nginx, 访问目标域名,若能访问到你开启的本地服务,则表示设置好了。

nginx常用命令

请通过nginx -h查看

# 启动nginx
nginx
# 重启nginx
nginx -s reload
# 退出nginx
nginx -s quit

Charles

安装Charles,分别在电脑和手机安装Charles证书,参考:此处-掘金文章

手机添加Charles连接:Help - SSL proxying - Install Charles Root Certificate On a Mobile Device or Remote Browser, 然后按提示:

  • 设置代理,手机连接到与电脑同一wifi, 并设置代理
  • 访问chls.pro/ssl下载证书,并安装证书(若安装失败,需自行找适合你所使用手机的安装方式,参考:https://www.jianshu.com/p/59c... R15是进入WLAN, 拉到底部有个"高级设置" - 安全证书管理 从存储设备安装,选择下载的证书并安装)

完毕后,通过手机访问目标域名,查看Charles的抓包,看对应的请求Remote Address是否为[target-host-name]/127.0.0.1:443, Client Address 则为手机的地址。

至此,就成功使得在手机上访问目标域名,实际上访问的是电脑开启的本地服务,达到了可以调试微信js-sdk的目的。

二次使用时大致流程

  • 确认hosts域名映射
  • 确认nginx https-server是否开启
  • 确认要调试的本地服务是否开启
  • 确认Charles打开
  • 确认手机开启代理,且证书没有问题

注意事项

  • 连接的WI-FI不能开启fanqiang
阅读 461

Web前端-困知记
分享开发过程中总结的相对完整之所得,主要以Web前端开发为主;多为困而学所得,故名困知记。

事不过三,消除重复

1.2k 声望
51 粉丝
0 条评论
你知道吗?

事不过三,消除重复

1.2k 声望
51 粉丝
宣传栏