本文详细解析了在使用Vue Router的addRoutes API动态添加路由时遇到的重复路由名警告问题，阐述了问题原因及两种解决策略：强制刷新页面与重置router的match属性，提供了一种优雅的解决方案。
最近项目中使用了vue-router的addRoutes这个api，遇到了一个小坑，记录总结一下。
场景复现：
做前端开发的同学，大多都遇到过这种需求：页面菜单根据用户权限动态生成，一个常见的解决方案是：
前端初始化的时候，只挂载不需要权限路由，如登陆，注册等页面路由，然后等用户登录之后，后端返回当前用户的权限表，前端根据这个权限表遍历前端路由表，动态生成用户权限路由，然后使用vue-router提供的addRoutes,将权限路由表动态添加到路由实例中，整个过程大致如下：
-
// router.js 文件 -
// 需要用户权限的路由表 -
const appRoutes = [ -
{ -
path: '/dashboard', -
name: 'dashboard', -
component: () => import('...'), -
children: [ -
RouteConfig1, -
RouteConfig2, -
... -
] -
}, -
RouteConfig, -
... -
]; -
// 不需要用户权限的路由表 -
const constantRoutes = [ -
{ -
path: '/login', -
name: 'login', -
component: Login -
}, -
{ -
path: '/register', -
name: 'register', -
component: Register -
}, -
... -
] -
// 初始化路由的时候，只挂载不需要用户权限的路由表 -
const router = new VueRouter({ -
mode: 'history', -
base: process.env.BASE_URL, -
constantRoutes -
}); -
/** -
* -
* 假如后端返回的数据格式如下： -
* -
* { -
* status: 200, -
* message: 'successful', -
* data: { -
* user: {...}, -
* token: '...', -
* permisssion: [...] -
* } -
* } -
* -
* login.vue -
*/ -
axios.post('/user/login',{username,password}) -
.then(res => { -
if (res.status === 200) { -
// 如果登录成功，则需要遍历生成用户权限路由 -
// filterRoutes根据permission和router.js中定义的appRoutes生成动态路由表 -
const routes = filterRoutes(permission); -
// 然后使用addRoutes将routes挂载到router中 -
router.addRoutes(routes); -
} else { -
... -
} -
}) -
.catch(error => { ... }) -
复制代码
写到这里，貌似动态生成路由的功能就好了，一切都perfect了，但问题紧接着就来了，当用户登录之后，我们点击页面上的退出按钮退出当前登录，然后重新登录，会发现浏览器console面板紧接着就报如下错误：
纳尼(⊙o⊙)？这是怎么回事呢，第二次登录也正常登录了，功能上似乎没有什么问题，但这个警告从哪里来的呢？对于一个重度强迫症患者来说，任何警告和报错都是不允许出现的，哪怕功能上没什么问题。
捋一捋
这段警告的意思是说，以上的这几个路由命名重复，存在多个name相同的路由。那么为什么会有多个路由名称相同的路由呢？
让我们从头捋一下这个错误是怎么来的。首先第一次打开网站登录的时候是没有问题的，只有当我们退出登录，重新登录的时候，这段警告就来了。并且如果我们在重复登录之前刷新一下浏览器然后再登录，这种警告就不会出现了，很神奇是不是？
分析一下上面的情景：首先这个警告只会在用户重新登录的时候出现，登录的时候我们做的唯一跟路由相关的事情就是动态添加路由，所以问题肯定出在 router.addRoutes(routes)这里，其次这里又分了两种情况：有刷新和无刷新。在无刷新的情况下会报这个警告，有刷新就不会报这个警告。那么有刷新和无刷新有什么区别呢？
我们很容易就想到，当页面刷新的时候，Vue实例会重新初始化，Vue实例初始化的过程中，挂载在它上面的Vue-Router,Store等内容也会重新初始化。而在不刷新的情况下，就不会重新初始化。
再想想，我们第一次登录之后，通过addRoutes添加了权限路由routes到router上，假设我们这个权限routes中包括了dashboard,user,role三个路由，那么当我们退出登录，然后重新登录的时候，由于同一个用户登录，后端返回的权限列表是一样的，生成的动态路由routes也是一样的（即里面同样包含了dashboard,user,role三个路由），那么此时再次添加这三个路由就导致router中挂载的routes重复。而在刷新的情况下，由于router重新初始化，只包含了初始化我们添加的不需要权限的路由，此时再次登录，重新添加就不存在路由重复的问题了。
通过以上的分析，我们搞清了问题的来源，那么如何解决呢，很遗憾，vue-router并没有删除路由的api。根据以上的分析，我们很容易想到，通过强制刷新页面的方式来重置router：即当用户退出登录的时候，通过js强制刷新一下页面。就可以解决问题。这种方式虽然可以解决问题，但显得不是很优雅，而且刷新页面导致资源重新加载和页面闪烁，体验也不是特别好。因此有没有在不刷新的情况下解决问题的办法呢？
经过一番搜索，终于找到了一种方法，即重置当前router的match属性：
-
router.js -
// 定义一个函数来创建router -
export const createRouter = routes => new VueRouter({ -
mode: 'history', -
base: process.env.BASE_URL, -
routes -
}); -
// 在使用addRoutes的地方 -
// 重置当前router的match = 初始router.match -
router.match = createRouter(constantRoutes).match; -
router.addRoutes(routes); -
复制代码
这样就可以完美解决问题了。
总结：
整个解决的过程还是比较痛苦的，因为实际中我的代码是比较复杂的，并不像上面简化后那么简单。整个addRoutes是在store.dispatch中完成，并且中间还夹杂着生成动态路由，根据动态路由再生成用户菜单等一系列功能，干扰比较大，并且这个是源码报警，不好定位，只能通过console和浏览器调试，一步步缩小报错范围，最终找到问题原因。然后再通过google，以及搜索vue-router仓库的issue一步步找到解决方法。所以想说，如果大家开发中遇到一些第三方依赖的问题，可以去搜索官方仓库的issue，很好用的，很多问题其实issue中都有答案。我是屡试不爽。最后，一定要用google，垃圾百度，浪费我好长时间，啥都没找到
扫一扫
1131
到【灌水乐园】发言
