微信小程序之微信登陆：微信小程序教程系列20

喜欢ヅ旅行 2021-12-03 14:17 829阅读 0赞

**简介：**

微信登陆，在新建一个微信小程序Hello World项目的时候，就可以看到项目中出现了我们的微信头像，其实这个Hello World项目，就有一个简化版的微信登陆。只不过是，还没有写入到咱们自家的后台中而已。

![20170523024244920][]

新建一个Hello World项目，找到app.js文件打开，代码如下：

**app.js：**

App({
    
      onLaunch: function () {
    
        //调用API从本地缓存中获取数据
    
        var logs = wx.getStorageSync('logs') || []
    
        logs.unshift(Date.now())
    
        wx.setStorageSync('logs', logs)
    
      },
    
      getUserInfo:function(cb){
    
        var that = this
    
        if(this.globalData.userInfo){
    
          typeof cb == "function" && cb(this.globalData.userInfo)
    
        }else{
    
          //调用登录接口
    
          wx.login({
    
            success: function () {
    
              wx.getUserInfo({
    
                success: function (res) {
    
                  that.globalData.userInfo = res.userInfo
    
                  typeof cb == "function" && cb(that.globalData.userInfo)
    
                }
    
              })
    
            }
    
          })
    
        }
    
      },
    
      globalData:{
    
        userInfo:null
    
      }
    
    })

登录部分为

//调用登录接口
    
          wx.login({
    
            success: function () {
    
              wx.getUserInfo({
    
                success: function (res) {
    
                  that.globalData.userInfo = res.userInfo
    
                  typeof cb == "function" && cb(that.globalData.userInfo)
    
                }
    
              })
    
            }
    
          })

## **下面详细介绍微信小程序的微信登陆** ##

### **第一步：获取登陆态code** ###

微信登陆部分，首先需要使用微信小程序的api—— wx.login(OBJECT)来获取登录态

这个登陆态的作用是为了获取用户的openid（用户的唯一标识）

![20170523024353295][]

**示例：官方示例**

**js：**

//调用登录
    
        wx.login({
    
          success: function(res) {
    
           console.log(res);
    
            if (res.code) {
    
              //发起网络请求
    
              //doSomething
    
            } else {
    
              console.log('获取用户登录态失败！' + res.errMsg)
    
            }
    
          },
    
      fail: function(){
    
        console.log("启用wx.login函数，失败！");
    
      },
    
      complete:function(){
    
        console.log("已启用wx.login函数");
    
      }
    
     
    
    });

TIPS：

上面这段代码的console.log(res);输出wx.login(OBJECT)的success成功回调函数返回值res的内容如下：

情况一：

出现这个code:”the code is a mock one”是在项目没有使用appid的情况下返回的，正常不是返回这个的！！

![20170523024438249][]

情况二：

项目在绑定appID后才能成功返回登录态，正确的登陆态如下图所示：

![20170523024501546][]

## ##

### **第二步：将登陆态code发送给第三方服务器（即自家的服务器）** ###

上面通过wx.login(OBJECT)获取了登录态后，接下来就是将code发送给第三方服务器

我们先看看微信登陆的序时图：

序时图所示，通过wx.login()获取了code后，就使用wx.request()发送code给第三方服务器（也就是自家的服务器）  
![20170523024528554][]

下面用代码来进行讲解这一步如何操作

**示例：官方示例**

把wx.login获取到的res.code返回值，直接以参数的形式，发起网络请求发送登陆态给自家服务器

**js：**

//调用登录
    
        wx.login({
    
          success: function(res) {
    
           console.log(res);
    
            if (res.code) {
    
              //就是在这里发起网络请求，使用wx.request()，将登陆态发送给自家的服务器上
    
              wx.request({
    
                url: 'https://test.com/onLogin',
    
                data: {
    
                  code: res.code
    
                },
    
                method: 'POST',  
    
          header: {'content-type': 'application/json'},
    
                success: function(data){
    
                }
    
              })
    
            } else {
    
              console.log('获取用户登录态失败！' + res.errMsg)
    
            }
    
          },
    
      fail: function(){
    
        console.log("启用wx.login函数，失败！");
    
      },
    
      complete:function(){
    
        console.log("已启用wx.login函数");
    
      }
    
    });

如何使用微信小程序发起网络请求？

请看如下教程：[微信小程序的网络请求：微信小程序教程系列14][14]

### **第三步：code 换取 session\_key和openid** ###

登陆态发送给自家的服务器后，接下来就是后台进行操作。

下面我把 自家的服务器简称 后台，方便阅读（你知道我说的后台指的是我们自己的服务器，而不是微信的服务器就行）。

后台接收到登陆态后，由后台发起网络请求给微信服务器

备注：后台没有语言要求！！任意一门后台语言都可以。

**接口地址：**

https://api.weixin.qq.com/sns/jscode2session

**参数说明：**  
![20170523024622094][]

备注：

appid和secret登陆微信公众平台，打开设置——开发设置，即可获取（app secret需要生成）。

![20170523024644672][]

grant\_type是固定写法，值为authorization\_code即可。

**返回结果：**

![20170523024717682][]

后台发送请求成后，腾讯服务器会返回session\_key 和 openid，如下图：

成功返回的结果

![20170523024956159][]

失败返回的结果

![20170523025023030][]

### **第四步：生成3rd\_session返回给客户端** ###

**第四步也是做后台中的操作！！**

此时把微信服务器返回的session\_key 和 openid保留在后台中，由于考虑安全性的问题，不要直接返回给客户端。

然后用操作系统提供的随机数算法生成一个新的session，微信把它叫做**3rd\_session**。（注意：这个session要有足够的长度，建议有2^128种组合，即长度为16B；设置一定的时效性）

以3rd\_session为名作为key，返回的session\_key和openid作为值，保存在后台上。

最后只需要在后台，返回一个3rd\_session给客户端即可。

以后客户端部分，就使用这个3rd\_session发送给后台，后台接收3rd\_session获取对应的session\_key和openid，再通过session\_key和openid判断对应的用户返回该用户相关的数据

备注：小程序用这种方法来代替浏览器自身发送的cookie，因为web的做法是服务器A会保存起访问登录接口的这个cookie到session中，当你再次访问其他接口的时候，服务器A首先会判断这个session，是否是之间的cookie从而知道是不是对应的用户。（http协议是一种短链接的关系，其特点是客户端发起请求链接到服务端，服务端返回数据，链接断开！因此之间是不会有任何数据的储存。）

**示例：接上示例**

**js：**

wx.login({
    
          success: function(res) {
    
           console.log(res);
    
            if (res.code) {
    
              wx.request({
    
                url: 'https://test.com/onLogin',
    
                data: {
    
                  code: res.code
    
                },
    
                method: 'POST',  
    
           header: {'content-type': 'application/json'},
    
    // 在发送请求成功的部分，返回的数据是后台返回的3rd_session
    
                success: function(data){
    
    console.log(data)
    
                }
    
              })
    
            } else {
    
              console.log('获取用户登录态失败！' + res.errMsg)
    
            }
    
          },
    
      fail: function(){
    
        console.log("启用wx.login函数，失败！");
    
      },
    
      complete:function(){
    
        console.log("已启用wx.login函数");
    
      }
    
    });

**PS：**

要是阅读到这里，有不明之处，请叫上后台的小伙伴一起过来阅读这篇文章

第三步，和第四步，要交给后台的同事去处理！！！

## **第五步：客户端保存3rd\_session** ##

回到客户端的工作了。

从第四步后台返回的3rd\_session后，需要将3rd\_session存入缓存中。

小程序提供了保存到本地缓存的api，使用非常简单。

（1）wx.setStorage(OBJECT)

传入key和data即可。

![20170523025055362][]

（2）wx.setStorageSync(KEY,DATA)

![20170523025158079][]

### **第六步：获取用户信息** ###

![20170523025226299][]

**示例：接上示例**

**js：**

wx.login({
    
          success: function(res) {
    
           console.log(res);
    
            if (res.code) {
    
              wx.request({
    
                url: 'https://test.com/onLogin',
    
                data: {
    
                  code: res.code
    
                },
    
                method: 'POST',  
    
           header: {'content-type': 'application/json'},
    
                success: function(data){
    
    console.log(data)
    
                }
    
              })
    
              // 使用wx.getUserInfo获取用户信息
    
      wx.getUserInfo({
    
            success: function (res) {
    
                utils.log(res);
    
            },
    
    fail:function(){
    
    console.log("启用app.getUserInfo函数，失败！");
    
    },
    
    complete:function(){
    
    console.log("已启用app.getUserInfo函数");   
    
          });
    
     
    
            } else {
    
              console.log('获取用户登录态失败！' + res.errMsg)
    
            }
    
          },
    
      fail: function(){
    
        console.log("启用wx.login函数，失败！");
    
      },
    
      complete:function(){
    
        console.log("已启用wx.login函数");
    
      }
    
    });

输出wx.getUserInfo的success成功回调函数返回值res的内容如下：

![20170523025307410][]

userInfo对象内是用户的信息：

avatarUrl: 用户头像

city: 城市

country: 国家

gender: 性别

language: 语言

nickName: 昵称

province: 省份

## **第七步：登录态维护** ##

通过上面六步，已经成功登陆微信小程序了，但是还需要做登陆维护。

也就是说，登陆小程序后，然后又退出该小程序了。在一段时间内，再次进入该小程序，视为有效登陆，如果超出这个指定的时间，则视为无效登陆，需要重新登陆

![20170523025333895][]

![20170523025348160][]

![20170523025412911][]

[20170523024244920]: /images/20211203/322c0fcc190f44b9a45b50634a143644.png
[20170523024353295]: /images/20211203/d81547957b2644feb59bc7a56a41a448.png
[20170523024438249]: /images/20211203/43cd5f4ac55b40fc93e4c5be263d47a8.png
[20170523024501546]: /images/20211203/dcc9ddd6de904730b46e5f422f9cfbed.png
[20170523024528554]: /images/20211203/8be52048955042f894e0cc74d24d1bad.png
[14]: https://blog.csdn.net/lwzhang1101/article/details/96429916
[20170523024622094]: /images/20211203/7ac373d168ea4147ab4ad797cbdc931e.png
[20170523024644672]: /images/20211203/6344328cbf9c49ad83e82b3278f3e48a.png
[20170523024717682]: /images/20211203/46f46e9f0c5a4251b2855b282ea78081.png
[20170523024956159]: /images/20211203/5c896e1c9c124bcfb2575685c8118778.png
[20170523025023030]: /images/20211203/8931c643bf5d4d2a903ce9d8bef64cfb.png
[20170523025055362]: /images/20211203/52584ebac68c428db7f1372e9ae1fbad.png
[20170523025158079]: /images/20211203/bdcaf6cae2c949468b87306d9ebbb6cf.png
[20170523025226299]: /images/20211203/b35c66f10a6e48a099c99a0d571bd58d.png
[20170523025307410]: /images/20211203/0aabe93842a64632ab562d280b6033a4.png
[20170523025333895]: /images/20211203/bd06a8b886a54ad6b760a8be4de8a7be.png
[20170523025348160]: /images/20211203/695f6505c8f944beb897fe44e5e85edc.png
[20170523025412911]: /images/20211203/ab44448d5af443a1949dd1d0e1cc86bb.png