範(fàn)例程式碼

  let reqTask = wx.request({
      url: getApp().globalData.api,
      success(res) {
        if (res.errMsg === "request:ok") console.log("res", res);
      },
      fail(err) {
        // if(err.errMsg.indexOf('request:fail')>-1) console.log('err', err);
        if (/^request:fail/i.test(err.errMsg)) console.log("err", err);
      },
      complete(res) {
        console.log("resOrErr", res);
      },
    });
   const reqTaskOnHeadersReceived = (headers) => {
      reqTask.offHeadersReceived(reqTaskOnHeadersReceived);
      console.log("headers", headers);
      // 由于請(qǐng)求還未完全結(jié)束，所以我們沒(méi)辦法獲得請(qǐng)求的狀態(tài)碼，但是我們可以通過(guò)返回的requestBody的長(zhǎng)度來(lái)進(jìn)行判斷。
      // 兩點(diǎn)說(shuō)明：1. 兩個(gè)~~可以把字符串?dāng)?shù)字快速轉(zhuǎn)化為數(shù)字。
      // 2. 為什么取小于19，是由于后臺(tái)返回沒(méi)有權(quán)限的requestBody的時(shí)候Content-length為“18”，正常情況下是大于19的。所以具體多少得看一下具體情況。
      if (~~headers.header["Content-length"] < 19) reqTask.abort();
    };
    reqTask.onHeadersReceived(reqTaskOnHeadersReceived);

小程式登入介面

• ##wx .getUserProfile(Object object)

  取得使用者資訊。頁(yè)面產(chǎn)生點(diǎn)擊事件（例如

  button 上 bindtap 的回調(diào)中）後才可調(diào)用，每次請(qǐng)求都會(huì)彈出授權(quán)窗口，用戶同意後返回 userInfo。此介面用於取代 wx.getUserInfo，詳見 使用者資訊介面調(diào)整說(shuō)明。

• wx.checkSession(Object object)

  檢查登入態(tài)是否過(guò)期。透過(guò) wx.login 介面獲得的使用者登入態(tài)擁有一定的時(shí)效性。使用者越久未使用小程序，使用者登入態(tài)越有可能失效。反之如果使用者一直在使用小程序，則使用者登入態(tài)一直保持有效。具體時(shí)效邏輯由微信維護(hù)，對(duì)開發(fā)者透明。開發(fā)者只需要呼叫 wx.checkSession 介面檢測(cè)目前使用者登入態(tài)是否有效。
  登入態(tài)過(guò)期後開發(fā)者可以再呼叫 wx.login 取得新的使用者登入狀態(tài)。呼叫成功說(shuō)明目前 session_key 未過(guò)期，呼叫失敗說(shuō)明 session_key 已過(guò)期。更多使用方法詳見

  小程式登入。

• wx.login(Object object)

  #呼叫介面取得登入憑證（code）。透過(guò)憑證進(jìn)而換取使用者登入態(tài)訊息，包括使用者在目前小程式的唯一識(shí)別（openid）、微信開放平臺(tái)帳號(hào)下的唯一識(shí)別（unionid，若目前小程式已綁定到微信開放平臺(tái)帳號(hào)）及本次登錄的會(huì)話金鑰（session_key）等。使用者資料的加解密通訊需要依賴會(huì)話金鑰完成。更多使用方法詳見

  小程式登入。

後端登入介面程式碼實(shí)作

#後端使用NodeJS，web框架KOA版本^2.13 .4，路由框架@koa/router版本^10.1.1，框架request，版本^2.88.2，jsonwebtoken用來(lái)加密解密token訊息，版本^8.5.1#

// app.js
const Koa = require("koa");
const Router = require("@koa/router");
const WeixinAuth = require("./lib/koa2-weixin-auth");
const jsonwebtoken = require("jsonwebtoken");

const app = new Koa();
// 小程序機(jī)票信息
const miniProgramAppId = "*********";
const miniProgramAppSecret = "***********";
const weixinAuth = new WeixinAuth(miniProgramAppId, miniProgramAppSecret);

const JWT_SECRET = "JWTSECRET";
// 路由中間件需要安裝@koa/router
// 開啟一個(gè)帶群組的路由
const router = new Router({
  prefix: "/user",
});
// 這是正規(guī)的登陸方法
// 添加一個(gè)參數(shù)，sessionKeyIsValid，代表sessionKey是否還有效
router.post("/weixin-login", async (ctx) => {
  let { code, userInfo, encryptedData, iv, sessionKeyIsValid } =
    ctx.request.body;
   // 解析openid
  const token = await weixinAuth.getAccessToken(code);
  userInfo.openid = token.data.openid;
  // 這里可以自己進(jìn)行處理，比方說(shuō)記錄到數(shù)據(jù)庫(kù),處理token等
  let authorizationToken = jsonwebtoken.sign(
    { name: userInfo.nickName },
    JWT_SECRET,
    { expiresIn: "1d" }
  );
  Object.assign(userInfo, { authorizationToken });
  ctx.status = 200;
  ctx.body = {
    code: 200,
    msg: "ok",
    data: userInfo,
  };
});

// lib/koa2-weixin-auth.js
const querystring = require("querystring");
const request = require("request");

const AccessToken = function (data) {
  if (!(this instanceof AccessToken)) {
    return new AccessToken(data);
  }
  this.data = data;
};

/*!
 * 檢查AccessToken是否有效，檢查規(guī)則為當(dāng)前時(shí)間和過(guò)期時(shí)間進(jìn)行對(duì)比
 *
 * Examples:
 * ```
 * token.isValid();
 * ```
 */
AccessToken.prototype.isValid = function () {
  return (
    !!this.data.session_key &&
    new Date().getTime() < this.data.create_at + this.data.expires_in * 1000
  );
};

/**
 * 根據(jù)appid和appsecret創(chuàng)建OAuth接口的構(gòu)造函數(shù)
 * 如需跨進(jìn)程跨機(jī)器進(jìn)行操作，access token需要進(jìn)行全局維護(hù)
 * 使用使用token的優(yōu)先級(jí)是：
 *
 * 1. 使用當(dāng)前緩存的token對(duì)象
 * 2. 調(diào)用開發(fā)傳入的獲取token的異步方法，獲得token之后使用（并緩存它）。

 * Examples:
 * ```
 * var OAuth = require(&#39;oauth&#39;);
 * var api = new OAuth(&#39;appid&#39;, &#39;secret&#39;);
 * ```
 * @param {String} appid 在公眾平臺(tái)上申請(qǐng)得到的appid
 * @param {String} appsecret 在公眾平臺(tái)上申請(qǐng)得到的app secret
 */
const Auth = function (appid, appsecret) {
  this.appid = appid;
  this.appsecret = appsecret;
  this.store = {};

  this.getToken = function (openid) {
    return this.store[openid];
  };

  this.saveToken = function (openid, token) {
    this.store[openid] = token;
  };
};

/**
 * 獲取授權(quán)頁(yè)面的URL地址
 * @param {String} redirect 授權(quán)后要跳轉(zhuǎn)的地址
 * @param {String} state 開發(fā)者可提供的數(shù)據(jù)
 * @param {String} scope 作用范圍，值為snsapi_userinfo和snsapi_base，前者用于彈出，后者用于跳轉(zhuǎn)
 */
Auth.prototype.getAuthorizeURL = function (redirect_uri, scope, state) {
  return new Promise((resolve, reject) => {
    const url = "https://open.weixin.qq.com/connect/oauth2/authorize";
    let info = {
      appid: this.appid,
      redirect_uri: redirect_uri,
      scope: scope || "snsapi_base",
      state: state || "",
      response_type: "code",
    };
    resolve(url + "?" + querystring.stringify(info) + "#wechat_redirect");
  });
};

/*!
 * 處理token，更新過(guò)期時(shí)間
 */
Auth.prototype.processToken = function (data) {
  data.create_at = new Date().getTime();
  // 存儲(chǔ)token
  this.saveToken(data.openid, data);
  return AccessToken(data);
};

/**
 * 根據(jù)授權(quán)獲取到的code，換取access token和openid
 * 獲取openid之后，可以調(diào)用`wechat.API`來(lái)獲取更多信息
 * @param {String} code 授權(quán)獲取到的code
 */
Auth.prototype.getAccessToken = function (code) {
  return new Promise((resolve, reject) => {
    const url = "https://api.weixin.qq.com/sns/jscode2session";
    //由于此框架版本很久沒(méi)有更新了，此處地址發(fā)生了變化，需要修改為以上地址，不然會(huì)出現(xiàn)
    //41008錯(cuò)誤。這也是沒(méi)有直接使用框架，引用本地使用的原因。
    // const url = "https://api.weixin.qq.com/sns/oauth2/access_token";
    const info = {
      appid: this.appid,
      secret: this.appsecret,
      js_code: code,
      grant_type: "authorization_code",
    };
    request.post(url, { form: info }, (err, res, body) => {
      if (err) {
        reject(err);
      } else {
        const data = JSON.parse(body);
        resolve(this.processToken(data));
      }
    });
  });
};

/**
 * 根據(jù)refresh token，刷新access token，調(diào)用getAccessToken后才有效
 * @param {String} refreshToken refreshToken
 */
Auth.prototype.refreshAccessToken = function (refreshToken) {
  return new Promise((resolve, reject) => {
    const url = "https://api.weixin.qq.com/sns/oauth2/refresh_token";
    var info = {
      appid: this.appid,
      grant_type: "refresh_token",
      refresh_token: refreshToken,
    };
    request.post(url, { form: info }, (err, res, body) => {
      if (err) {
        reject(err);
      } else {
        const data = JSON.parse(body);
        resolve(this.processToken(data));
      }
    });
  });
};

/**
 * 根據(jù)openid，獲取用戶信息。
 * 當(dāng)access token無(wú)效時(shí)，自動(dòng)通過(guò)refresh token獲取新的access token。然后再獲取用戶信息
 * @param {Object|String} options 傳入openid或者參見Options
 */
Auth.prototype.getUser = async function (openid) {
  const data = this.getToken(openid);
  console.log("getUser", data);
  if (!data) {
    var error = new Error(
      "No token for " + options.openid + ", please authorize first."
    );
    error.name = "NoOAuthTokenError";
    throw error;
  }
  const token = AccessToken(data);
  var accessToken;
  if (token.isValid()) {
    accessToken = token.data.session_key;
  } else {
    var newToken = await this.refreshAccessToken(token.data.refresh_token);
    accessToken = newToken.data.session_key;
  }
  console.log("accessToken", accessToken);
  return await this._getUser(openid, accessToken);
};

Auth.prototype._getUser = function (openid, accessToken, lang) {
  return new Promise((resolve, reject) => {
    const url = "https://api.weixin.qq.com/sns/userinfo";
    const info = {
      access_token: accessToken,
      openid: openid,
      lang: lang || "zh_CN",
    };
    request.post(url, { form: info }, (err, res, body) => {
      if (err) {
        reject(err);
      } else {
        resolve(JSON.parse(body));
      }
    });
  });
};

/**
 * 根據(jù)code，獲取用戶信息。
 * @param {String} code 授權(quán)獲取到的code
 */
Auth.prototype.getUserByCode = async function (code) {
  const token = await this.getAccessToken(code);
  return await this.getUser(token.data.openid);
};

module.exports = Auth;

小程式端登入程式碼實(shí)作

<!--pages/index.wxml-->
<view class="page-section">
    <text class="page-section__title">微信登錄</text>
    <view class="btn-area">
        <button  bindtap="getUserProfile" type="primary">登錄</button>
    </view>
</view>

// pages/index.js
Page({
  /**
   * 頁(yè)面的初始數(shù)據(jù)
   */
  data: {},
  // 正確的登錄方式
  getUserProfile() {
    // 推薦使用wx.getUserProfile獲取用戶信息，開發(fā)者每次通過(guò)該接口獲取用戶個(gè)人信息均需用戶確認(rèn)
    // 開發(fā)者妥善保管用戶快速填寫的頭像昵稱，避免重復(fù)彈窗
    wx.getUserProfile({
      desc: "用于完善會(huì)員資料", // 聲明獲取用戶個(gè)人信息后的用途，后續(xù)會(huì)展示在彈窗中，請(qǐng)謹(jǐn)慎填寫
      success: (res) => {
        let { userInfo, encryptedData, iv } = res;
        const requestLoginApi = (code) => {
          // 發(fā)起網(wǎng)絡(luò)請(qǐng)求
          wx.request({
            url: "http://localhost:3000/user/weixin-login",
            method: "POST",
            header: {
              "content-type": "application/json",
            },
            data: {
              code,
              userInfo,
              encryptedData,
              iv,
            },
            success(res) {
              console.log("請(qǐng)求成功", res.data);
              let token = res.data.data.authorizationToken;
              wx.setStorageSync("token", token);
              onUserLogin(token);
              console.log("authorization", token);
            },
            fail(err) {
              console.log("請(qǐng)求異常", err);
            },
          });
        };
        const onUserLogin = (token) => {
          getApp().globalData.token = token;
          wx.showToast({
            title: "登錄成功了",
          });
        };
        //必須進(jìn)行session是否過(guò)期檢查，不然會(huì)出現(xiàn)第一次點(diǎn)擊登錄，服務(wù)器報(bào)Illegal Buffer
        //的錯(cuò)誤，但是第二次點(diǎn)擊登錄正常。
        wx.checkSession({
          success: (res) => {
            // session_key 未過(guò)期，并且在本生命周期一直有效
            console.log("在登陸中");
            let token = wx.getStorageSync("token");
            if (token) onUserLogin(token);
          },
          fail: (res) => {
            // session_key已經(jīng)失效，需要重新執(zhí)行登錄流程
            wx.login({
              success(res0) {
                if (res0.code) {
                  requestLoginApi(res0.code);
                } else {
                  console.log("登錄失敗!" + res0.errMsg);
                }
              },
            });
          },
        });
      },
    });
  },
});

#針對(duì)登入程式碼可以做哪些最佳化？

• 可維護(hù)性（maintainability）
  所謂的「維護(hù)」無(wú)外乎就是修改bug、修改舊的程式碼、新增新的程式碼之類的工作。所謂「程式碼易??維護(hù)」就是指，在不破壞原有程式碼設(shè)計(jì)、不引入新的 bug 的情況下，能夠快速地修改或新增程式碼。所謂「程式碼不易維護(hù)」就是指，修改或新增程式碼需要冒著極大的引入新 bug 的風(fēng)險(xiǎn)，並且需要花費(fèi)很長(zhǎng)的時(shí)間才能完成。

• 可讀性（readability）
  軟體設(shè)計(jì)大師Martin Fowler 曾經(jīng)說(shuō)過(guò)：「Any fool can write code that a computer can understand. Good programmers write code that humans can understand.」翻譯成中文就是：「任何傻瓜都會(huì)寫電腦能理解的程式碼。好的程式設(shè)計(jì)師能夠編寫人能夠理解的程式碼。」Google 內(nèi)部甚至專門有個(gè)認(rèn)證就叫作Readability。只有拿到這個(gè)認(rèn)證的工程師，才有資格在 code review 的時(shí)候，就批準(zhǔn)別人提交代碼。可見程式碼的可讀性有多重要，畢竟，程式碼被閱讀的次數(shù)遠(yuǎn)遠(yuǎn)超過(guò)被編寫和執(zhí)行的次數(shù)。我們需要看程式碼是否符合編碼規(guī)範(fàn)、命名是否達(dá)意、註解是否詳盡、函數(shù)是否長(zhǎng)短適當(dāng)、模組劃分是否清晰、是否符合高內(nèi)聚低耦合等等。

• 可擴(kuò)充性（extensibility）
  可擴(kuò)充性也是一個(gè)評(píng)價(jià)程式碼品質(zhì)非常重要的標(biāo)準(zhǔn)。程式碼預(yù)留了一些功能擴(kuò)充點(diǎn)，你可以把新功能程式碼，直接插到擴(kuò)充點(diǎn)上，而不需要因?yàn)橐黾右粋€(gè)功能而大動(dòng)幹戈，改動(dòng)大量的原始程式碼。

• 可重複使用性（reusability）

  代碼的可復(fù)用性可以簡(jiǎn)單地理解為，盡量減少重復(fù)代碼的編寫，復(fù)用已有的代碼。

那么接下來(lái)就來(lái)優(yōu)化一下代碼吧：

模塊化

可以把登錄的代碼模塊化，代碼如下：

// lib/login.js
function loginWithCallback(cb) {
  // 推薦使用wx.getUserProfile獲取用戶信息，開發(fā)者每次通過(guò)該接口獲取用戶個(gè)人信息均需用戶確認(rèn)
  // 開發(fā)者妥善保管用戶快速填寫的頭像昵稱，避免重復(fù)彈窗
  wx.getUserProfile({
    desc: "用于完善會(huì)員資料", // 聲明獲取用戶個(gè)人信息后的用途，后續(xù)會(huì)展示在彈窗中，請(qǐng)謹(jǐn)慎填寫
    success: (res) => {
      let { userInfo, encryptedData, iv } = res;
      const requestLoginApi = (code) => {
        // 發(fā)起網(wǎng)絡(luò)請(qǐng)求
        wx.request({
          url: "http://localhost:3000/user/weixin-login",
          method: "POST",
          header: {
            "content-type": "application/json",
          },
          data: {
            code,
            userInfo,
            encryptedData,
            iv,
          },
          success(res) {
            console.log("請(qǐng)求成功", res.data);
            let token = res.data.data.authorizationToken;
            wx.setStorageSync("token", token);
            onUserLogin(token);
            console.log("authorization", token);
          },
          fail(err) {
            console.log("請(qǐng)求異常", err);
          },
        });
      };

      const onUserLogin = (token) => {
        getApp().globalData.token = token;
        wx.showToast({
          title: "登錄成功了",
        });
        if (cb && typeof cb == "function") cb(token);
      };
      wx.checkSession({
        success: (res) => {
          // session_key 未過(guò)期，并且在本生命周期一直有效
          console.log("在登陸中");
          let token = wx.getStorageSync("token");
          if (token) onUserLogin(token);
        },
        fail: (res) => {
          // session_key已經(jīng)失效，需要重新執(zhí)行登錄流程
          wx.login({
            success(res0) {
              if (res0.code) {
                requestLoginApi(res0.code);
              } else {
                console.log("登錄失敗!" + res0.errMsg);
              }
            },
          });
        },
      });
    },
  });
}

export default loginWithCallback;

Promise化

回調(diào)地獄問(wèn)題，不利于代碼的閱讀，所以接下來(lái)我們基于Promise進(jìn)行代碼優(yōu)化。有了 Promise 對(duì)象，就可以將異步操作以同步操作的流程表達(dá)出來(lái)，避免了層層嵌套的回調(diào)函數(shù)。此外，Promise 對(duì)象提供統(tǒng)一的接口，使得控制異步操作更加容易。

Promise的幾個(gè)方法簡(jiǎn)介

小程序API接口Promise化并且把需要登錄的調(diào)用接口模塊化

1、安裝插件。請(qǐng)先查看npm支持文檔。

npm install --save miniprogram-api-promise

2、在微信開發(fā)者工具右方詳情中勾選使用npm模塊，并在菜單欄工具中點(diǎn)擊構(gòu)建npm。

3、初始化代碼。

// app.js
import {promisifyAll} from 'miniprogram-api-promise'
import login from "../lib/login";
const wxp ={}
promisifyAll(wx,wxp)
// 需要token的請(qǐng)求統(tǒng)一處理登錄和設(shè)置header，并且處理錯(cuò)誤信息
wxp.requestNeedLogin = async function (args) {
  let token = wx.getStorageSync("token");
  if (!token) {
    token = await loginWithPromise();
  }
  if (!args.header) args.header = {};
  args.header["Authorization"] = `Bearer ${token}`;
  return wxp.request(args).catch(console.error);
};
// app.js
App({
  wxp:wxp,
});

4、改寫login.js代碼

// lib/login.js
function login() {
  return new Promise((resolve, reject) => {
    // 推薦使用wx.getUserProfile獲取用戶信息，開發(fā)者每次通過(guò)該接口獲取用戶個(gè)人信息均需用戶確認(rèn)
    // 開發(fā)者妥善保管用戶快速填寫的頭像昵稱，避免重復(fù)彈窗
    wx.getUserProfile({
      desc: "用于完善會(huì)員資料", // 聲明獲取用戶個(gè)人信息后的用途，后續(xù)會(huì)展示在彈窗中，請(qǐng)謹(jǐn)慎填寫
       success:async (res0) => {
        let {
          userInfo,
          encryptedData,
          iv
        } = res0;
        const app = getApp();
        try {
          app.wxp.checkSession();
        } catch (err) {
          reject(err);
        }
        let token = wx.getStorageSync("token");
        if (!token) {
          let res1 = await app.wxp.login().catch(err => reject(err));
          let code = res1.code;
          let res = await app.wxp.request({
            url: "http://localhost:3000/user/weixin-login",
            method: "POST",
            header: {
              "content-type": "application/json",
            },
            data: {
              code,
              userInfo,
              encryptedData,
              iv,
            }
          }).catch(err => reject(err));
          token = res.data.data.authorizationToken;
          wx.setStorageSync("token", token);
          app.globalData.token = token;
          wx.showToast({
            title: "登錄成功了",
          });
          resolve(token);
        }
      },
    });
  })
}

export default login;

5、調(diào)用代碼

<view class="container page-head">
  <text class="page-section__title">需要登錄的請(qǐng)求調(diào)用</text>
  <view class="btn-area">
    <button bindtap="request1" type="primary">請(qǐng)求1</button>
    <button bindtap="request2" type="primary">請(qǐng)求2</button>
  </view>
</view>

// pages/index.js
Page({
  /**
   * 頁(yè)面的初始數(shù)據(jù)
   */
  data: {},
  request1() {
    getApp().wxp.requestNeedLogin({
        url: "http://localhost:3000/user/home?name=andying",
      }).then(console.log)
  },
  request2() {
    getApp().wxp.requestNeedLogin({
        url: "http://localhost:3000/user/home?name=eva",
      }).then(console.log)
  },
});

【相關(guān)學(xué)習(xí)推薦：小程序開發(fā)教程】