Vue實現(xiàn)路由守衛(wèi)的示例代碼

更新時間：2025年09月25日 08:30:55 作者：一只游魚

Vue路由守衛(wèi)是控制頁面導(dǎo)航的鉤子函數(shù),主要用于鑒權(quán)、數(shù)據(jù)預(yù)加載等場景,文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

一、概念

路由守衛(wèi)（Navigation Guards）本質(zhì)上就是 在路由跳轉(zhuǎn)前后，攔截用戶導(dǎo)航并做一些邏輯處理的鉤子函數(shù)。
常見用途有：

鑒權(quán)控制：比如沒有登錄就不允許進入某些頁面。
數(shù)據(jù)預(yù)加載：在進入某個頁面前，提前拉取數(shù)據(jù)。
頁面跳轉(zhuǎn)控制：比如離開頁面前彈出“是否保存更改”的提示。

簡單理解：路由守衛(wèi)就是 Vue Router 提供的一種“鉤子函數(shù)”，用來控制頁面導(dǎo)航的行為。

二、類型

Vue Router 提供了三類守衛(wèi)：

（1）全局守衛(wèi)

對所有路由跳轉(zhuǎn)都生效。

// 全局前置守衛(wèi)
router.beforeEach((to, from, next) => {
  const token = localStorage.getItem('token')
  if (to.meta.requiresAuth && !token) {
    // 需要登錄，但沒 token，跳轉(zhuǎn)到登錄
    next('/login')
  } else {
    next()
  }
})
// 全局后置守衛(wèi)（一般用來修改標(biāo)題等）
router.afterEach((to) => {
  document.title = to.meta.title || '默認標(biāo)題'
})
export default router

（2）路由獨享守衛(wèi)

只針對某一個路由生效。

{
  path: '/profile',
  component: () => import('@/views/Profile.vue'),
  beforeEnter: (to, from, next) => {
    const token = localStorage.getItem('token')
    if (!token) {
      next('/login')
    } else {
      next()
    }
  }
}

（3）組件內(nèi)守衛(wèi)

直接寫在組件里，對進入/離開當(dāng)前組件生效。

export default {
  name: 'Profile',
  // 進入當(dāng)前組件之前
  beforeRouteEnter(to, from, next) {
    console.log('即將進入 Profile 頁面')
    next()
  },
  // 路由更新（比如 /profile/1 -> /profile/2）
  beforeRouteUpdate(to, from, next) {
    console.log('路由參數(shù)變化，更新頁面數(shù)據(jù)')
    next()
  },
  // 離開當(dāng)前組件時
  beforeRouteLeave(to, from, next) {
    const answer = window.confirm('確定要離開嗎？未保存的數(shù)據(jù)會丟失')
    if (answer) {
      next()
    } else {
      next(false) // 阻止導(dǎo)航
    }
  }
}

三、實戰(zhàn)

以下為作者的演示：

全局守衛(wèi)
如果token過期或token錯誤會返回到登錄頁面

注意：以上效果需要配合JWT來實現(xiàn)，詳情請看我的博客文章：

JWT令牌

在index.Js文件中寫入全局守衛(wèi)：

// 全局前置守衛(wèi)
router.beforeEach((to, from, next) => {
  const token = localStorage.getItem('token') // 從本地取 token
  if (to.meta.requiresAuth && !token) {
    // 如果需要登錄且沒有 token，就跳到登錄頁
    next({ path: '/' })
  } else {
    next() // 其他情況放行
  }
})

在request.Js中添加攔截器：

// 響應(yīng)攔截器：統(tǒng)一處理 401
request.interceptors.response.use(
  (response) => response,
  (error) => {
    if (error.response && error.response.status === 401) {
      localStorage.removeItem("token"); // 清除過期 token
      router.push("/"); // 跳轉(zhuǎn)到登錄頁
    }
    return Promise.reject(error);
  }
);

可以試驗一下，登錄成功進入ai頁面后：