聊一聊实现Vue路由组件缓存遇到的’坑‘

背景介绍

最近在做公司后台管理系统项目时遇到一个比较怪异的bug——采用keep-alive+vue-router实现的路由缓存遇到缓存不生效的情况。

vue-router组件缓存未生效的bug

项目背景

此项目是基于iview-admin@2.0进行开发的,全局状态管理采用vuex分module实现,路由采用vue-router进行路由配置表的方式实现。

项目属于基于RBAC的后台管理系统,需要多用户多角色的权限控制,同时路由功能菜单以及展示的字段需按角色划分,因此左侧系统菜单根据接口进行动态设置。

项目中可以进行菜单的图标、跳转路径、是否隐藏等进行配置,路径对应的前端路由则由前端的路由记录进行管理,即菜单管理功能设置的跳转路径是否可用由此路由记录决定。

解决过程

核实路由缓存用法问题

发现这个bug之后梳理了一遍路由组件缓存的实现方案,同时仔细核对了一遍vue-router的官方文档

官方推荐的用法如下:

<transition>
  <keep-alive>
    <router-view></router-view>
  </keep-alive>
</transition>

可以排除基本用法的问题,如是继续翻阅vue的官方文档,keep-alive的缓存匹配原理是根据组件的name作为key来进行缓存,官方的提示

vue-router官网的提示

随即检查代码中的路由记录的name以及对应component的name,发现都有定义好,因此排除基本用法的错误导致。

iview-admin的不完善导致

进行上述问题排查后定位到此问题出在keep-alive组件的include参数处,keep-alive的参数说明如下:

  • include - 字符串或正则表达式。只有名称匹配的组件会被缓存。
  • exclude - 字符串或正则表达式。任何名称匹配的组件都不会被缓存。
  • max - 数字。最多可以缓存多少组件实例。

iview-admin@2.0中通过路由的meata参数——notCache来控制路由对应的组件是否进行缓存,其源码中有如下注释说明:

设为true后页面在切换标签后不会缓存,如果需要缓存,无需设置这个字段,而且需要设置页面组件name属性和路由配置的name一致

其文档文档上关于路由meta参数的说明在这里

其注释说明说要让组件实现缓存必须要保证页面组件的name和路由配置的name一致,而该项目中路由配置根据由后台设置功能决定,故修改不能缓存的页面的路由配置的namne即可解决问题。

仅仅是解决了此bug总感觉还不够,不如顺便研究一个iview-admin的源码是如何实现路由缓存的。

iview-admin实现路由组件缓存原理

iview-admin路由组件缓存原理
iview-admin路由组件缓存原理

iview-admin中将navTagList、menuList等数据保存在全局的vuex的app模块中,navTagList是当前的当前打开过的标签页数组根据路由变化动态更新;menuList是当前登录用户的菜单数组,默认根据路由记录的meta参数的access字段进行过滤

cacheList是app模块的的getters之一,用户从tagNavList中计算出当前打开的标签页需要用keep-alive缓存的组件name数组,此处采用的是动态修改keep-alive组件的exclude的值来动态更新路由的缓存规则

iview-admin的一些局限

iview-admin中的用户权限路由控制思路是:采用路由meata参数的access数组来标签当前路由可访问的用户角色,根据路由记录计算出对应用户的menuList进行渲染。

这个实现方案存在一些不足:

  • 路由采用配置表的方式由前端进行配置,路由需要更新时需要前端更新代码进行打包部署的整套项目发布流程
  • 菜单完全由路由配置即用户角色计算得出,后端不能够灵活的重置页面菜单显示

基于以上这些考虑对iview-admin默认的权限控制、路由配置进行如下的优化。

考虑优化方案

路由分类划分

项目中的路由组件包括Man.vue进行布局控制,404.vue 500.vue等处理前端路由异常的展示,login.vue error_log.vue等展示用户注册登录日志记录等页面,这些页面路由通常不会经常更新不需要进行动态注册,而像其他的复杂业务逻辑处理页面需要接口进行动态配置。

故将路由进行拆分,基础路由——routers-common直接配置到router中,业务路由——routers进行动态注册

路由分类

路由动态注册

vuex的store中的user模块添加获取用户路由配置的action——getUserRoutes,在用户登录成功后或者或者Main.vue的mounted生命周期中根据用户token调用接口获取用户路由配置

调用router.addRoutes方法进行路由的动态注册。

更进一步

本文最终对遇到的vue路由缓存bug进行了修复,同时也对项目进行了一定的优化改造,后续对于vue-router源码的进一步研究也已经完成,想知道本文遇到的’坑‘在源码中是如何’埋下‘的,请阅读我专栏的下一篇文章——带你全面分析vue-router源码(万字长文)

若此文对你有一点点帮助请点个赞鼓励下作者,毕竟原创不易:)
首发自语雀:https://www.yuque.com/johniexu/frontend/dhgooo
作者博客地址:blog.lessing.online/
作者github:github.com/johniexu

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,293评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,604评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,958评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,729评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,719评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,630评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,000评论 3 397
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,665评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,909评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,646评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,726评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,400评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,986评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,959评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,996评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,481评论 2 342