二維碼本質上就是「存了二進位資料的黑白圖片」。掃碼登入的流程是:伺服器產生一組臨時且唯一的識別碼(uuid),前端把它渲染成二維碼圖片顯示在頁面;手機掃描後確認授權,網頁端則是不停地問伺服器「被授權了嗎?」,直到收到成功回應或逾時作廢。

整個授權流程可以概括成下圖:

網頁端會持續向伺服器送出 HTTPS 請求,傳輸的資料量極小,收到回應後立刻斷開再重送。微信網頁版的 login.js 把這件事拆成兩個函式:_getUUID() 取得識別碼,_poll() 負責輪詢狀態。
function _loadQRImg(uuid) {
_poll(uuid);
_oLoginQrCodeImg.src = "https://login." + _sBaseHost + "/qrcode/" + uuid + "?t=webwx";
// 看門狗:每 5 秒檢查圖片是否還在,最多重試 5 次
loadQRImgWatchDog = setInterval(function(){
if (reLoadQRImgCount >= 5) { _reset(); return; }
reLoadQRImgCount++;
var _img = new Image();
_img.onload = function(){ _oLoginQrCodeImg.src = this.src; };
_img.src = _oLoginQrCodeImg.src + "&r=" + new Date().getTime();
}, 5000);
}
這段有兩個值得學的細節:用 &r=時間戳 讓 src 每次都不同,避免瀏覽器快取到舊圖;另外用 setInterval 當「看門狗」,若圖片一直載不進來就重新抓,超過次數則整頁重載。
function _poll(_asUUID) {
var _self = arguments.callee;
$.ajax({
type: "GET",
url: "https://login." + _sBaseHost + "/cgi-bin/mmwebwx-bin/login?uuid=" + _asUUID + "&tip=" + show_tip,
dataType: "script",
cache: false,
timeout: 100 * 1000,
success: function(data, textStatus, jqXHR) {
switch (window.code) {
case 200: // 已授權,接著換取真正的登入憑證
var _fNewLoginFunc = function(){
$.ajax({
url: _aoWin.redirect_uri + "&fun=new",
type: "GET",
success: function(msg) {
var code = msg.match(/<script>(.*)<\/script>/);
if (code) { eval(code[1]); }
}
});
};
_fNewLoginFunc();
break;
case 201: // 已掃描,等待手機端確認
show_tip = 0;
$('.successMsg').show();
_self(_asUUID); // 繼續輪詢
break;
case 408: // 尚未掃描,500ms 後再問
setTimeout(function(){ _self(_asUUID); }, 500);
break;
case 400:
case 500: // uuid 失效或伺服器異常,重載
_reset();
break;
}
},
error: function(jqXHR, textStatus){
setTimeout(function(){ _self(_asUUID); }, textStatus == 'timeout' ? 500 : 5000);
}
});
}
狀態碼就是整個流程的心臟:408 代表還沒人掃,201 代表掃了但等手機確認,200 代表授權完成可以換取憑證,400/500 則要作廢重來。 timeout 設為 100 秒是刻意的——這其實是長輪詢,伺服器會把請求掛住直到狀態改變或逾時,比短間隔輪詢省資源。
_oResetTimeout = setTimeout(function(){
location.reload(); // 5 分鐘後重載,注意別用 _reset(),否則可能產生多個 _poll 併行
}, 5 * 60 * 1000);
作者特別在註解裡標明:這裡要用 location.reload() 而非 _reset(),因為直接重啟輪詢會讓多個 _poll 同時跑(它們都收到 408 後各自重排下一輪),造成請求堆積。這是很典型的「重試要收斂」問題。
arguments.callee 遞迴呼叫在嚴格模式下已被禁用,現代寫法應改用具名函式表達式。eval(code[1]) 是舊時代做法,服務端回傳可執行腳本本身就是風險點,如今應改為回傳 JSON 再由前端處理。理解這套流程後,不難看懂近年各種「用手機 App 授權電腦端」的設計——它們骨架幾乎一致,差別只在狀態碼定義與輪詢間隔。