手把手教你如何在Mac本地調試微信JS SDK

在微信內置瀏覽器中通過微信JS SDK,可以使用微信提供的功能,例如設置分享鏈接的標題和圖片、調起微信支付、打開掃一掃等等。
根據官方文檔,前端在使用微信的接口前要先進行配置,如下:

wx.config({
    debug: true, // 調試模式
    appId: '', // 必填,公衆號的唯一標識
    timestamp: , // 必填,生成簽名的時間戳
    nonceStr: '', // 必填,生成簽名的隨機串
    signature: '',// 必填,簽名
    jsApiList: [] // 必填,需要使用的JS接口列表
});

配置信息得從後端獲取,後端在計算signature時需要前端傳入當前頁面的URL。開發者要在公衆平臺設置JS SDK安全域名,在這個域名下才能使用微信JS SDK。也就是說調用JS SDK一共有 2 個條件:

  1. 在微信內置瀏覽器訪問,或者在電腦端的微信開發者工具;
  2. 在指定域名下訪問,也就是在公衆平臺設置的安全域名。

我們要做的就是讓指定域名映射到本地,就可以將 HTTP 請求發送 給開發服務器,主要就是修改 hosts 文件。假設在公衆平臺設置的JS SDK安全域名爲wx.example.com,本地調試微信 SDK 的步驟如下:

一、修改 hosts 文件,將域名映射到127.0.0.1 IP地址

$ sudo vim /etc/hosts
# 在host文件底部添加以下內容
127.0.0.1 wx.example.com

由於本地開發服務器監聽的是 8080 端口,還得將 8080 端口轉發給默認的 80 端口。先檢查有沒有進程在監聽 80 端口,然後再轉發。使用 lsof 命令查看有沒有進程在監聽 80 端口。

$ lsof -i -P -n | grep LISTEN
ss-local   3065 admin    6u  IPv4 0xa8ba2df099418f61      0t0  TCP 127.0.0.1:1086 (LISTEN)
redis-ser  3079 admin    4u  IPv4 0xa8ba2df09adbcc39      0t0  TCP 127.0.0.1:6379 (LISTEN)
privoxy    3085 admin    3u  IPv4 0xa8ba2df09adbd531      0t0  TCP 127.0.0.1:8118 (LISTEN)
privoxy    3085 admin    4u  IPv4 0xa8ba2df09b378341      0t0  TCP *:8118 (LISTEN)
postgres   3098 admin    6u  IPv4 0xa8ba2df09adbba49      0t0  TCP 127.0.0.1:5432 (LISTEN)

既然沒有進程在監聽 80 端口,接下來配置端口轉發,參考這篇文章Mac pfctl Port Forwarding

# 轉發80端口到8080端口
$ echo " rdr pass inet proto tcp from any to any port 80 -> 127.0.0.1 port 8080" | sudo pfctl -ef -
# 查看當前端口轉發規則
$ sudo pfctl -s nat
# 移除端口轉發規則,不必執行
# sudo pfctl -F all -f /etc/pf.conf

我前端是一個 Vue 項目,轉發端口後,頁面返回 Invalid Host header,需要在my_project/build/webpack.dev.conf.js文件中找到devServer配置,增加一個選項。

devServer: {
  ...,
  disableHostCheck: true
}

現在就可以 Mac 的微信開發者工具中調試JSSDK了,在地址欄輸入:wx.example.com,就會將請求轉發給本地開發服務器了,如下圖。

二、搭建代理服務器

不過我們的目的是在手機上調試,接下來我們要在 Mac 上使用 SquidMan 來搭建代理服務器,代理來自手機的HTTP請求。把發去wx.example.com的請求轉發給127.0.0.1:8080
2.1 下載 SquidMan
2.2 配置 SquidMan
由於 SquidMan 默認監聽8080端口,跟我的開發服務器衝突了。打開Preferences,我把它改成了8087


切換到template選項卡,修改兩行配置

# 修改http_access deny all
http_access allow all
# 修改http_access deny to_localhost
http_access allow to_localhost

點擊保存,然後啓動。


  1. 手機設置代理服務器


確保你手機跟 Mac 連接到同一個局域網(比如連着同一個 WiFi)。然後打開手機的無線設置,設置代理。
通過ifconfig查看 Mac 的局域網ip地址,端口則是我們剛剛在 Squid Man 設置的 8087。

$ ifconfig
en1: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
    ether 5c:96:9d:71:ed:xx
    inet6 fe80::1822:21d3:s3xx:89d6%en1 prefixlen 64 secured scopeid 0x4
    inet 192.168.2.108 netmask 0xffffff00 broadcast 192.168.2.255
    nd6 options=201<PERFORMNUD,DAD>
    media: autoselect
    status: active

我 Mac 的局域網 ip 地址是 192.168.2.108。保存無線設置後,就可以在微信打開wx.example.com進行本地調試了!

可以在命令行實時查看代理服務器的access_log

$ tail -200f ~/Library/Logs/squid/squid-access.log
1522428241.979    308 192.168.2.107 TCP_TUNNEL/200 5517 CONNECT data.mistat.xiaomi.com:443 - HIER_DIRECT/203.100.93.112 -
1522428252.031  65516 192.168.2.107 TCP_TUNNEL/200 5716 CONNECT open.account.xiaomi.com:443 - HIER_DIRECT/118.26.252.5 -
1522428338.333  85084 192.168.2.107 TCP_TUNNEL/200 4414 CONNECT sp1.baidu.com:443 - HIER_DIRECT/14.215.177.39 -
1522428343.297  60954 192.168.2.107 TAG_NONE/503 0 CONNECT accounts.google.com:443 - HIER_NONE/- -
1522428354.021   3269 192.168.2.107 TCP_TUNNEL/200 3411 CONNECT hd.xiaojukeji.com:443 - HIER_DIRECT/139.199.240.46 -
1522428354.251   9750 192.168.2.107 TAG_NONE/000 0 CONNECT clients4.google.com:443 - HIER_NONE/- -
1522428354.251 119853 192.168.2.107 TAG_NONE/000 0 CONNECT clients4.google.com:443 - HIER_NONE/- -
1522428354.251 168879 192.168.2.107 TAG_NONE/000 0 CONNECT clients4.google.com:443 - HIER_NONE/- -
1522428354.251  67289 192.168.2.107 TCP_TUNNEL/200 4311 CONNECT update.googleapis.com:443 - HIER_DIRECT/203.208.40.55 -
1522428354.251   3499 192.168.2.107 TCP_TUNNEL/200 3343 CONNECT omgup.xiaojukeji.com:443 - HIER_DIRECT/123.207.209.54 -
1522428198.886      2 192.168.2.107 TCP_MISS/304 243 GET http://wx.example.cn/admin - HIER_DIRECT/127.0.0.1 -

注意最後一行,Squid Man將發送到wx.example.cn的請求轉發給了127.0.0.1

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章