axios请求失败自动重发

来源：https://wintc.top/article/53

在做Vue、React项目的时候常会用axios请求库来与后端进行数据交互。我们通常采用一个用户凭证token来验证用户身份，服务器根据token进行判断当前用户是否有权限调用接口。

经常遇到的一个问题是，调用接口时token可能已经过期，此时调用接口会失败，需要重新登录后再调用接口。通常我们可能处理为，用户走完登录流程后再重新手动触发一次请求。这样的实现本身没什么问题，但是给用户的操作体验上有被中断的感觉，今天尝试解决了一下这个问题。

一、业务痛点

我的业务场景是，当一个接口（比如”用户发表评论“）返回token过期或者未验证的状态码时，调出登录弹窗，登录成功后再次发送评论请求。当然我们可以在评论接口处对状态码进行判断，token失效则重新发送请求；如果有其它接口也类似处理。这个方法最大的问题在于对于每个接口都要单独处理，然而程序员最大的优点就是——懒。这个方法虽然可行，对于一个懒人来说并不怎么好用，那更好的办法的是什么呢？

二、业务实现——以登录过期，重新发送请求为例（Vue实现）

axios请求拦截器本身可以获取请求的地址、参数、超时时间等配置，请求的重发变得很简单；同时axios库的请求返回为一个promise对象，得益于Promise强大的嵌套异步处理，可以使得请求接口调用对请求重发“无感”——即调用接口的时候你可以默认它一定成功，因为失败的情况在拦截器已经重发了。

1. 使用拦截器进行请求重发

function getToken () {
    return localStorage.getItem('token')
}

function clearToken () {
    localStorage.removeItem('token')
}

function setToken (token) {
    localStorage.setItem('token', token)
}

function login () {
    // 登录处理代码
}

const instance = axios.create({
    baseURL: 'http://xxxx', // 请求域名前缀
    timeout: 10 * 1000
})
const requestError = error => Promise.reject(error)
const beforeRequest = config => {
    config.headers['token'] = getToken() || undefined
    return config
}
const beforeResponse = res => () => {
    if (res.data.code == 401) { // 401错误表示未登录授权或者token失效
    clearToken()
    return login().then(() => {
        return instance.request(res.config) // 这里是核心代码，登录成功后重新请求！返回Promise对象。
    })
    }
    return res
}
instance.interceptors.request.use(beforeRequest, requestError)
instance.interceptors.response.use(beforeResponse, requestError)

2.登录调用（login函数）封装

上述代码里重新请求部分调用了login函数（login().then(callback)），login函数体空置了，接下来将讨论其实现。login预期返回一个Proimise，登录成功则Promise.then注册的回调函数将被调用。

 我们可以将登录弹窗封装为一个组件，然后通过手动挂载组件来函数式地调用登录流程。可以在登录组件内部提供一个函数以供外部login函数调用，比如showModal，该函数直接返回一个Promise，login函数只要调用该函数并直接返回即可。

登录组件Login.vue封装：

<template>
  <div v-show="show">
      <!-- 登录框 -->
  </div>
</template>

<script>
export default {
  data () {
    return {
      username: '',
      password: '',
      resolve: null,
      reject: null,
      show: false
    }
  },
  methods: {
    showModal () {
      return new Promise((resolve, rejcet) => {
        this.show = true
        this.resolve = resolve
        this.reject = reject
      })
    },
    hideModal () {
      this.show = false
      this.reject = null
      this.resolve = null
      this.username = ''
      this.password = ''
    },
    success () {
      this.hideModal()
      this.resolve && this.resolve()
    },
    fail () {
      this.hideModal()
      this.reject && this.reject()
    }
  }
}
</script>

封装好了Login.vue组件，接下来实现login函数：

import Login from '@/components/Login.vue'
import Vue from 'vue'
// ...
let vm = null
function login() {
  if (!vm) {
    const LoginConstructor = Vue.extend(Login)
    vm = new LoginConstructor().$mount()
  }
  return vm.showModal()
}
// ...

login函数闭包了一个外部变量vm，目的是通过vm引用已创建的Login组件实例，避免重复创建（即“单例”）。这样，完整的登录后重发请求流程即完成了。

三、总结

一般而言只要谈到异步，通常提到回调函数。JS里的Promise是一个强大的回调函数管理器。本文的实现方案正是利用了Promise的特性，在接口无权限时，将“登录+重新请求”的过程封装为Promise并返回，实现接口调用过程中无权限登录统一处理。这样在接口调用的地方，可以不用单独处理无权限的情况，一定程度上避免用户操作被登录流程打断。