TNW-獲取微信公衆號的 access_token

簡介

TNW: TypeScript(The) + Node.js(Next) + WeChat 微信公衆號開發腳手架，支持 http 模塊擴展、支持任何 Node.js 的服務端框架(Express、NestJS、eggjs 等)

概述

access_token 是公衆號的全局惟一接口調用憑據，公衆號調用各接口時都需使用 access_token。開發者須要進行妥善保存。access_token 的存儲至少要保留 512 個字符空間。access_token 的有效期目前爲2個小時，需定時刷新，重複獲取將致使上次獲取的 access_token 失效。

公衆平臺的API調用所需的 access_token 的使用及生成方式說明：

一、建議公衆號開發者使用中控服務器統一獲取和刷新 access_token，其餘業務邏輯服務器所使用的access_token 均來自於該中控服務器，不該該各自去刷新，不然容易形成衝突，致使 access_token 覆蓋而影響業務；

二、目前 access_token 的有效期經過返回的 expire_in 來傳達，目前是 7200 秒以內的值。中控服務器須要根據這個有效時間提早去刷新新 access_token。在刷新過程當中，中控服務器可對外繼續輸出的老 access_token，此時公衆平臺後臺會保證在5分鐘內，新老 access_token均可用，這保證了第三方業務的平滑過渡；

三、access_token 的有效時間可能會在將來有調整，因此中控服務器不只須要內部定時主動刷新，還須要提供被動刷新 access_token 的接口，這樣便於業務服務器在API調用獲知 access_token 已超時的狀況下，能夠觸發access_token 的刷新流程。

公衆號和小程序都可以使用 AppId 和 AppSecret 調用本接口來獲取 access_token。AppId 和 AppSecret 可在「微信公衆平臺-開發-基本配置」頁中得到（須要已經成爲開發者，且賬號沒有異常狀態）。**調用接口時，請登陸「微信公衆平臺-開發-基本配置」提早將服務器 IP 地址添加到 IP 白名單中，不然將沒法調用成功。**小程序無需配置IP白名單。

以上內容來自 官方文檔

劃重點：

• 調用 access_token 接口須要在微信公衆平臺配置 IP 白名單
• access_token 有效期爲 7200 秒
• 能夠提早刷新 access_token ，此時公衆平臺後臺會保證在5分鐘內新老 access_token 均可用

TNW 中獲取 access_token

export class AccessTokenApi {
    private static url: string = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=%s&secret=%s";
    /** * 獲取 acces_token * 一、先從緩存中獲取，若是可用就直接返回 * 二、若是緩存中的已過時就調用刷新接口來獲取新的 acces_token */
    public static async getAccessToken() {
        let ac: ApiConfig = ApiConfigKit.getApiConfig;
        let accessToken: AccessToken | undefined = this.getAvailableAccessToken(ac);
        if (accessToken) {
            if(ApiConfigKit.isDevMode) console.log("緩存中的 accesstoken");
            return accessToken;
        }
        if(ApiConfigKit.isDevMode) console.log("刷新 accesstoken");
        return await this.refreshAccessToken(ac);;
    }

    /** * 經過 appId 從緩存中獲取 acces_token * @param apiConfig */
    private static getAvailableAccessToken(apiConfig: ApiConfig): AccessToken | undefined {
        let result: AccessToken | undefined;
        let accessTokenCache: IAccessTokenCache = ApiConfigKit.getAccessTokenCache;
        let accessTokenJson: string = accessTokenCache.get(apiConfig.getAppId);
        if (accessTokenJson) {
            result = new AccessToken(accessTokenJson);
        }
        if (result && result.isAvailable()) {
            return result;
        } else {
            return undefined;
        }
    }

    /** * 獲取新的 acces_token 並設置緩存 * @param apiConfig */
    public static async refreshAccessToken(apiConfig: ApiConfig) {
        let url = util.format(this.url, apiConfig.getAppId, apiConfig.getAppScrect);
        let data = await HttpKit.getHttpDelegate.httpGet(url);
        if (data) {
            let accessToken: AccessToken = new AccessToken(data)
            let accessTokenCache: IAccessTokenCache = ApiConfigKit.getAccessTokenCache;
            accessTokenCache.set(apiConfig.getAppId, accessToken.getCacheJson);
            return accessToken;
        } else {
            new Error("獲取accessToken異常");
        }
    }
}
複製代碼

默認 access_token 緩存在內存中，但這有一個缺點，當應用關閉後又得從新獲取。因此 TNW 中提供了設置緩存的擴展。

緩存擴展

access_token 緩存接口 IAccessTokenCache

export interface IAccessTokenCache {
    get(key: string): string;
    set(key: string, jsonValue: string): void;
    remove(key: string): void;
}
複製代碼

默認實現 DefaultAccessTokenCache

export class DefaultAccessTokenCache implements IAccessTokenCache {

    private map: Map<string, string> = new Map<string, string>();

    get(key: string): string {
        return this.map.get(key) || '';
    }

    set(key: string, jsonValue: string) {
        this.map.set(key, jsonValue);
    }

    remove(key: string) {
        this.map.delete(key);
    }
}
複製代碼

設置替換默認緩存

DefaultAccessTokenCache 替換爲你的實現類便可 好比：緩存至文件、Redis 等

ApiConfigKit.setAccessTokenCache(new DefaultAccessTokenCache());
複製代碼

遺留問題

直接傳入接口的實現類會出現異常 沒法調用類型缺乏調用簽名的表達式 待解決

開源推薦

• TNW 微信公衆號開發腳手架：gitee.com/javen205/TN…
• IJPay 讓支付觸手可及：gitee.com/javen205/IJ…
• SpringBoot 微服務高效開發 mica 工具集：gitee.com/596392912/m…
• Avue 一款基於 vue 可配置化的神奇框架：gitee.com/smallweigit…
• pig 宇宙最強微服務（架構師必備）：gitee.com/log4j/pig
• SpringBlade 完整的線上解決方案（企業開發必備）：gitee.com/smallc/Spri…