Vue路由导航守卫进阶，一文搞懂

最新推荐文章于 2025-11-18 16:37:55 发布

原创最新推荐文章于 2025-11-18 16:37:55 发布 · 630 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#vue.js #前端 #javascript

"导航”表示路由正在发生改变，vue-router提供的导航守卫通过跳转或取消的方式守卫导航。有多种机会植入路由导航过程中：全局的，单个路由独享的，或者组件级的。

1、全局前置守卫

const router = new VueRouter({ ... })

router.beforeEach((to, from, next) => {

})

当一个导航触发时，全局前置守卫按照创建顺序调用，守卫是异步解析执行，此时导航在所有守卫resolve完之前一直处于等待中

每个守卫接受3个参数：

to：路由对象，表示即将进入的目标路由对象

from：路由对象，当前导航正要离开的路由

next：方法，一定要调用这个方法来 resolve 这个钩子。执行效果依赖next 方法调用参数

next()：进行管道中的下一个钩子。如果全部钩子执行完了，则导航的状态就是 confirmed（确认的）

next(false)：中断当前的导航。如果浏览器的 URL改变了（可能是用户手动或者浏览器后退按钮），那么URL地址会重置到 form 路由对应的地址

next('/')或者next({path: '/'})：跳转到一个不同的地址。当前的导航被中断，然后进行一个新的导航。可以向 next 传递任意位置对象，且允许设置诸如 replace： true, name: 'home'之类的选项以及任何用在 router-link 的 to prop 或 router.push 中的选项

注意：确保next 函数在任何给定的导航守卫中都被严格调用1次。可以出现多次，但整你在所有的逻辑路径都不重叠的情况下，否则钩子永远不会被解析或报错

2、全局解析守卫（2.5.0新增）

router.boforeResolve 注册一个全局守卫。这和router.beforeEach类似。区别是在导航被确认前，同时在所有组件内守卫和异步路由组件被解析之后，解析守卫就被调用

3、全局后置钩子

也可以注册全局后置钩子，和守卫不同的是，这些钩子不会接受next 函数也不会改变导航本身

单个路由独享的---路由独享守卫

const router = new VueRouter({
  routes: [
    {
      path: '/foo',
      component: Foo,
      beforeEnter: (to, from, next) => {
        // ...
      }
    }
  ]
})

参数与全局前置守卫的方法参数是一样的

组件内的守卫

可以在路由组件内直接定义以下路由导航守卫

beforeRouteEnter：

const Foo = {
  template: `...`,
  beforeRouteEnter(to, from, next) {
    // 在渲染该组件的对应路由被 confirm 前调用
    // 不！能！获取组件实例 `this`
    // 因为当守卫执行前，组件实例还没被创建
  },
  beforeRouteUpdate(to, from, next) {
    // 在当前路由改变，但是该组件被复用时调用
    // 举例来说，对于一个带有动态参数的路径 /foo/:id，在 /foo/1 和 /foo/2 之间跳转的时候，
    // 由于会渲染同样的 Foo 组件，因此组件实例会被复用。而这个钩子就会在这个情况下被调用。
    // 可以访问组件实例 `this`
  },
  beforeRouteLeave(to, from, next) {
    // 导航离开该组件的对应路由时调用
    // 可以访问组件实例 `this`
  }
}

守卫不能方位this, 因为守卫在导航确认前被调用，因此即将登场的新组建还没被创建，不过可以通过传一个回调给 next 来方位组件实例。在导航被确认的时候执行回调，并且把组件实例作为回调方法的参数

beforeRouteEnter (to, from, next) {
  next(vm => {
    // 通过 `vm` 访问组件实例
  })
}

beforeRouteUpdate(2.2新增)：已经可以使用this，不支持传递回调

beforeRouteLeave：已经可以使用this，不支持传递回调，通常用来禁止用户还未保存修改之前突然离开，该导航可以通过next(false)来取消

完整的导航解析流程

导航被触发。
在失活的组件里调用 beforeRouteLeave 守卫。
调用全局的 beforeEach 守卫。
在重用的组件里调用 beforeRouteUpdate 守卫 (2.2+)。
在路由配置里调用 beforeEnter。
解析异步路由组件。
在被激活的组件里调用 beforeRouteEnter。
调用全局的 beforeResolve 守卫 (2.5+)。
导航被确认。
调用全局的 afterEach 钩子。
触发 DOM 更新。
调用 beforeRouteEnter 守卫中传给 next 的回调函数，创建好的组件实例会作为回调函数的参数传入。