查看原文
其他

6 种 Vue 权限路由实现方式总结(最全)

若邪 全栈修炼 2022-03-19

使用全局路由守卫

实现

前端定义好路由,并且在路由上标记相应的权限信息

const routerMap = [
  {
    path: '/permission',
    component: Layout,
    redirect: '/permission/index',
    alwaysShow: true
    meta: {
      title: 'permission',
      icon: 'lock',
      roles: ['admin''editor'
    },
    children: [{
      path: 'page',
      component: () => import('@/views/permission/page'),
      name: 'pagePermission',
      meta: {
        title: 'pagePermission',
        roles: ['admin'
      }
    }, {
      path: 'directive',
      component: () => import('@/views/permission/directive'),
      name: 'directivePermission',
      meta: {
        title: 'directivePermission'

      }
    }]
  }]

全局路由守卫每次都判断用户是否已经登录,没有登录则跳到登录页。

已经登录 (已经取得后台返回的用户的权限信息(角色之类的)),则判断当前要跳转的路由,用户是否有权限访问 (根据路由名称到全部路由里找到对应的路由,判断用户是否具备路由上标注的权限信息 (比如上面的roles : [ 'admin', 'editor' ]))。

没有权限则跳到事先定义好的界面 ( 403、404 之类的)。

这种方式,菜单可以直接用路由生成 (用户没有权限的菜单也会显示,点击跳转的时候才做权限判断),也可以在用户登录后根据用户权限把路由过滤一遍生成菜单 (菜单需要保存在 vuex 里)。

目前 iview-admin 还是用的这种方式

  • 加载所有的路由,如果路由很多,而用户并不是所有的路由都有权限访问,对性能会有影响。

  • 全局路由守卫里,每次路由跳转都要做权限判断。

  • 菜单信息写死在前端,要改个显示文字或权限信息,需要重新编译。

  • 菜单跟路由耦合在一起,定义路由的时候还有添加菜单显示标题,图标之类的信息,而且路由不一定作为菜单显示,还要多加字段进行标识。

登录页与主应用分离

针对前一种实现方式的缺点,可以将登录页与主应用放到不同的页面 (不在同一个 Vue 应用实例里)。

实现

登录成功后,进行页面跳转 (真正的页面跳转,不是路由跳转),并将用户权限传递到主应用所在页面,主应用初始化之前,根据用户权限筛选路由,筛选后的路由作为 vue 的实例化参数,而不是像前一种方式所有的路由都传递进去,也不需要在全局路由守卫里做权限判断了。

缺点

  • 需要做页面跳转,不是纯粹的单页应用。

  • 菜单信息写死在前端,要改个显示文字或权限信息,需要重新编译。

  • 菜单跟路由耦合在一起,定义路由的时候还有添加菜单显示标题,图标之类的信息,而且路由不一定作为菜单显示,还要多加字段进行标识。

使用 addRoutes 动态挂载路由

addRoutes 允许在应用初始化之后,动态的挂载路由。有了这个新姿势,就不用像前一种方式那样要在应用初始化之要对路由进行筛选。

实现

应用初始化的时候先挂载不需要权限控制的路由,比如登录页,404 等错误页。

有个问题,addRoutes 应该何时调用,在哪里调用

登录后,获取用户的权限信息,然后筛选有权限访问的路由,再调用 addRoutes 添加路由。

这个方法是可行的。但是不可能每次进入应用都需要登录,用户刷新浏览器又要登陆一次。

所以 addRoutes 还是要在全局路由守卫里进行调用

import router from './router'
import store from './store'
import { Message } from 'element-ui'
import NProgress from 'nprogress' 
import 'nprogress/nprogress.css'
import { getToken } from '@/utils/auth' 

NProgress.configure({ showSpinner: false })


function hasPermission(roles, permissionRoles) {
  if (roles.indexOf('admin') >= 0return true 
  if (!permissionRoles) return true
  return roles.some(role => permissionRoles.indexOf(role) >= 0)
}

const whiteList = ['/login''/authredirect']

router.beforeEach((to, from, next) => {
  NProgress.start() 
  if (getToken()) { 

    if (to.path === '/login') {
      next({ path: '/' })
      NProgress.done() 
    } else {
      if (store.getters.roles.length === 0) { 
        store.dispatch('GetUserInfo').then(res => { 
          const roles = res.data.roles 
          store.dispatch('GenerateRoutes', { roles }).then(() => { 
            router.addRoutes(store.getters.addRouters) 
            next({ ...to, replace: true }) 
          })
        }).catch((err) => {
          store.dispatch('FedLogOut').then(() => {
            Message.error(err || 'Verification failed, please login again')
            next({ path: '/' })
          })
        })
      } else {
        if (hasPermission(store.getters.roles, to.meta.roles)) {
          next()
        } else {
          next({ path: '/401', replace: true, query: { noGoBack: true }})
        }
      }
    }
  } else {
    if (whiteList.indexOf(to.path) !== -1) { 
      next()
    } else {
      next('/login'
      NProgress.done() 
    }
  }
})

router.afterEach(() => {
  NProgress.done() 
})

关键的代码如下

if (store.getters.roles.length === 0) { 
        store.dispatch('GetUserInfo').then(res => { 
          const roles = res.data.roles 
          store.dispatch('GenerateRoutes', { roles }).then(() => { 
            router.addRoutes(store.getters.addRouters) 
            next({ ...to, replace: true }) 
          })
        }).catch((err) => {
          store.dispatch('FedLogOut').then(() => {
            Message.error(err || 'Verification failed, please login again')
            next({ path: '/' })
          })
        })
}

上面的代码就是 vue-element-admin 的实现

缺点

  • 全局路由守卫里,每次路由跳转都要做判断

  • 菜单信息写死在前端,要改个显示文字或权限信息,需要重新编译

  • 菜单跟路由耦合在一起,定义路由的时候还有添加菜单显示标题,图标之类的信息,而且路由不一定作为菜单显示,还要多加字段进行标识

菜单与路由分离,菜单由后端返回

菜单的显示标题,图片等需要随时更改,要对菜单做管理功能。

后端直接根据用户权限返回可访问的菜单。

实现

前端定义路由信息 ( 标准的路由定义,不需要加其他标记字段 )。

{
    name"login",
    path: "/login",
    component: () => import("@/pages/Login.vue")
}

name 字段都不为空,需要根据此字段与后端返回菜单做关联。

做菜单管理功能的时候,一定要有个字段与前端的路由的 name 字段对应上 ( 也可以是其他字段,只要菜单能找到对应的路由或者路由能找到对应的菜单就行 ) ,并且做唯一性校验。

菜单上还需要定义权限字段,可以是一个或多个。

其他信息,比如显示标题,图标,排序,锁定之类的,可以根据实际需求进行设计。

还是在全局路由守卫里做判断

function hasPermission(router, accessMenu) {
  if (whiteList.indexOf(router.path) !== -1) {
    return true;
  }
  let menu = Util.getMenuByName(router.name, accessMenu);
  if (menu.name) {
    return true;
  }
  return false;

}

Router.beforeEach(async (to, from, next) => {
  if (getToken()) {
    let userInfo = store.state.user.userInfo;
    if (!userInfo.name) {
      try {
        await store.dispatch("GetUserInfo")
        await store.dispatch('updateAccessMenu')
        if (to.path === '/login') {
          next({ name: 'home_index' })
        } else {
          next({ ...to, replace: true })
        }
      }  
      catch (e) {
        if (whiteList.indexOf(to.path) !== -1) { 
          next()
        } else {
          next('/login')
        }
      }
    } else {
      if (to.path === '/login') {
        next({ name: 'home_index' })
      } else {
        if (hasPermission(to, store.getters.accessMenu)) {
          Util.toDefaultPage(store.getters.accessMenu,to, routes, next);
        } else {
          next({ path'/403',replace:true })
        }
      }
    }
  } else {
    if (whiteList.indexOf(to.path) !== -1) { 
      next()
    } else {
      next('/login')
    }
  }
  let menu = Util.getMenuByName(to.name, store.getters.accessMenu);
  Util.title(menu.title);
});

Router.afterEach((to) => {
  window.scrollTo(00);
});

上面代码是 vue-quasar-admin 的实现。因为没有使用 addRoutes ,每次路由跳转的时候都要判断权限,这里的判断也很简单,因为菜单的 name 与路由的 name 是一一对应的,而后端返回的菜单就已经是经过权限过滤的,所以如果根据路由 name 找不到对应的菜单,就表示用户有没权限访问。

如果路由很多,可以在应用初始化的时候,只挂载不需要权限控制的路由。取得后端返回的菜单后,根据菜单与路由的对应关系,筛选出可访问的路由,通过 addRoutes 动态挂载。

缺点

  • 菜单需要与路由做一一对应,前端添加了新功能,需要通过菜单管理功能添加新的菜单,如果菜单配置的不对会导致应用不能正常使用。

  • 全局路由守卫里,每次路由跳转都要做判断

菜单与路由完全由后端返回

菜单由后端返回是可行的,但是路由由后端返回呢 ?看一下路由的定义

{
    name"login",
    path: "/login",
    component: () => import("@/pages/Login.vue")
}

后端如果直接返回

{
    "name""login",
    "path""/login",
    "component""() => import('@/pages/Login.vue')"
}

这是什么鬼,明显不行。() => import('@/pages/Login.vue') 这代码如果没出现在前端,webpack 不会对 Login.vue 进行编译打包。

实现

前端统一定义路由组件,比如

const Home = () => import("../pages/Home.vue");
const UserInfo = () => import("../pages/UserInfo.vue");
export default {
  home: Home,
  userInfo: UserInfo
};

将路由组件定义为这种 key-value 的结构。

后端返回格式

[
      {
        name: "home",
        path"/",
        component: "home"
      },
      {
        name: "home",
        path"/userinfo",
        component: "userInfo"
      }
]

在将后端返回路由通过 addRoutes 动态挂载之间,需要将数据处理一下,将 component 字段换为真正的组件。

至于菜单与路由是否还要分离,怎么对应,可以根据实际需求进行处理。

如果有嵌套路由,后端功能设计的时候,要注意添加相应的字段。前端拿到数据也要做相应的处理。

缺点

  • 全局路由守卫里,每次路由跳转都要做判断

  • 前后端的配合要求更高

不使用全局路由守卫

前面几种方式,除了 登录页与主应用分离,每次路由跳转,都在全局路由守卫里做了判断。

实现

应用初始化的时候只挂载不需要权限控制的路由。

const constRouterMap = [
  {
    name: "login",
    path: "/login",
    component: () => import("@/pages/Login.vue")
  },
  {
    path: "/404",
    component: () => import("@/pages/Page404.vue")
  },
  {
    path: "/init",
    component: () => import("@/pages/Init.vue")
  },
  {
    path: "*",
    redirect: "/404"
  }
];
export default constRouterMap;
import Vue from "vue";
import Router from "vue-router";
import ConstantRouterMap from "./routers";

Vue.use(Router);

export default new Router({

  scrollBehavior: () => ({ y: 0 }),
  routes: ConstantRouterMap
});

登录成功后跳到 / 路由

submitForm(formName) {
      let _this=this;
      this.$refs[formName].validate(valid => {
        if (valid) {
          _this.$store.dispatch("loginByUserName",{
            name:_this.ruleForm2.name,
            pass:_this.ruleForm2.pass
          }).then(()=>{
            _this.$router.push({
              path:'/'
            })
          })
        } else {

          return false;
        }
      });
    }

因为当前没有/路由,会跳到 /404

<template>
  <h1>404</h1>
</template>
<script>
export default {
  name:'page404',
  mounted(){
    if(!this.$store.state.isLogin){
      this.$router.replace({ path: '/login' });
      return;
    }
    if(!this.$store.state.initedApp){
       this.$router.replace({ path: '/init' });
       return
    }
  }
}
</script>

404 组件里判断已经登录,接着判断应用是否已经初始化 ( 用户权限信息,可访问菜单,路由等是否已经从后端取得) 。没有初始化则跳转到 /init 路由。

<template>
  <div></div>
</template>
<script>
import { getAccessMenuList } from "../mock/menus";
import components from "../router/routerComponents.js";
export default {
  async mounted() {
    if (!this.$store.state.isLogin) {
      this.$router.push({ path: "/login" });
      return;
    }
    if (!this.$store.state.initedApp) {
      const loading = this.$loading({
        lock: true,
        text: "初始化中",
        spinner: "el-icon-loading",
        background: "rgba(0, 0, 0, 0.7)"
      });
      let menus = await getAccessMenuList(); //模拟从后端获取
      var routers = [...menus];
      for (let router of routers) {
        let component = components[router.component];
        router.component = component;
      }
      this.$router.addRoutes(routers);
      this.$store.dispatch("setAccessMenuList", menus).then(() => {
        loading.close();
        this.$router.replace({
          path: "/"
        });
      });
      return;
    } else {
      this.$router.replace({
        path: "/"
      });
    }
  }
};
</script>

init 组件里判断应用是否已经初始化 (避免初始化后,直接从地址栏输入地址再次进入当前组件)。

如果已经初始化,跳转 / 路由 (如果后端返回的路由里没有定义次路由,则会跳转 404)。

没有初始化,则调用远程接口获取菜单和路由等,然后处理后端返回的路由,将 component 赋值为真正 的组件,接着调用 addRoutes 挂载新路由,最后跳转 / 路由即可。菜单的处理也是在此处,看实际需求。

实现例子

缺点

  • 在 404 页面做了判断,感觉比较怪异

  • 多引入了一个init页面组件

总结

比较推荐后面两种实现方式。

作者:若邪
https://juejin.im/post/5b5bfd5b6fb9a04fdd7d687a



往期精文


Vue.js 作者在 VueConf 2019 上海关于 Vue3.0 演讲视频

7 个有用的 Vue 开发技巧

一张思维导图辅助你深入了解 Vue | Vue-Router | Vuex 源码架构 

vue-cli3.x 新特性及踩坑记

那些必会用到的 ES6 精粹


欢迎关注以下公众号 全栈修炼,学到不一样的武功秘籍 !

关注公众号并回复 福利 可领取免费学习资料,福利详情请猛戳: 免费资源获取--Python、Java、Linux、Go、node、vue、react、javaScript


您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存