做過一次微信相關專案後,把過程中的筆記整理出來分享。內容以授權流程為主軸,附上幾個實際開發時才會遇到的瑣碎但關鍵的細節。若有不足或錯誤之處,歡迎指正。

整體流程可以概括為:使用者進入頁面 → 判斷本地有無可用的 openid → 若無則導向微信授權網址 → 微信回傳 code → 後端用 code 換取 access_token 與 openid → 需要更多資料時再呼叫 userinfo 介面 → 把資料回傳前端保存並渲染畫面。
其中最容易出錯的環節有三個:redirect_uri 未做 URL 編碼、網域未加入網頁授權回調域名清單、code 被重複使用(code 只能用一次且五分鐘內有效)。逐一排除這三項,多數「授權一直失敗」的問題都能解決。
var myNickname;
var myHeadimgurl;
var activityId;
function saveData() {
var obj = {};
obj.openId = myOpenId; // 微信 openid
obj.nickname = myNickname; // 微信暱稱
obj.headimgurl = myHeadimgurl; // 使用者頭像
// obj.activityimg = "xx"; // 活動圖片
}
/*
* 注意:localStorage 中的內容使用者是可以直接看到的,
* 因此有這樣一個說法:重要資料不建議以此方式存放。
*/
// 存值
localStorage.setItem("openId", openId);
localStorage.setItem("accesstoken", accesstoken);
// 取值
openId = localStorage.getItem("openId");
accesstoken = localStorage.getItem("accesstoken");
這段提醒值得認真看待。localStorage 以純文字形式存在使用者裝置上,任何人打開開發者工具都能讀取甚至竄改。因此:
1. 先準備測試資料。事先取得幾組真實的 openid 存起來,這樣在電腦瀏覽器上除錯時,就不必每次都走一次授權,能省下大量時間。
2. 微信授權無法在本機直接除錯。授權回調必須指向已上線、且已在後台配置好的網域,因此每改一次就得發布到伺服器上才能驗證。這點在報進度時最好先跟客戶或團隊說清楚,否則「看起來什麼都沒做」的誤會很容易發生;若必須密集調整,安排在下班後或流量低峰時段會更順利。
最後補充一個容易忽略的細節:微信內的網頁快取相當頑固,CSS 與 JS 更新後經常不會即時生效。與其依賴使用者清快取,不如在資源網址後加上版本號或雜湊值,讓快取自然失效。