Vue Router动态路由与导航守卫实战

在 Vue Router 中，动态路由与导航守卫的结合使用能够实现复杂的路由控制逻辑，例如权限验证、动态路由加载、数据预取等功能。以下是一个结合实战的详细说明：

---

一、动态路由基础

动态路由通过路径参数（:）实现动态匹配，常用于根据参数渲染不同内容：

// router.js
const routes = [
  {
    path: '/user/:id',
    name: 'User',
    component: UserProfile,
    props: true // 推荐：通过 props 解耦参数
  }
];

组件中获取参数

<!-- UserProfile.vue -->
<template>
  <div>User ID: {{ userId }}</div>
</template>

<script>
export default {
  props: ['id'], // 通过 props 接收参数
  computed: {
    userId() {
      return this.id;
    }
  }
}
</script>

---

二、导航守卫核心用法

导航守卫分为全局守卫、路由独享守卫和组件内守卫。

1. 全局前置守卫 (beforeEach)

用于全局权限验证或路由拦截：

// router.js
router.beforeEach((to, from, next) => {
  const isAuthenticated = checkAuth(); // 假设的验证函数
  if (to.meta.requiresAuth && !isAuthenticated) {
    next({ name: 'Login' }); // 重定向到登录页
  } else {
    next(); // 放行
  }
});

2. 路由独享守卫 (beforeEnter)

针对特定路由的验证：

// router.js
{
  path: '/admin',
  component: AdminPanel,
  beforeEnter: (to, from, next) => {
    if (user.role !== 'admin') next('/403'); // 权限不足跳转
    else next();
  }
}

3. 组件内守卫 (beforeRouteEnter, beforeRouteUpdate)

• beforeRouteEnter : 进入组件前调用（无法访问 this）
• beforeRouteUpdate: 路由参数变化但组件复用时调用

// UserProfile.vue
export default {
  beforeRouteEnter(to, from, next) {
    // 预取数据（例如通过 API）
    fetchUserData(to.params.id).then(user => {
      next(vm => vm.setUserData(user)); // 通过回调传递数据
    });
  },
  beforeRouteUpdate(to, from, next) {
    // 参数变化时重新获取数据
    this.fetchUserData(to.params.id);
    next();
  },
  methods: {
    setUserData(user) {
      this.user = user;
    }
  }
}

---

三、动态路由 + 导航守卫实战场景

场景 1：动态添加路由（基于权限）

根据用户角色动态生成可访问路由：

// 登录后动态添加路由
function setupRoutes(userRole) {
  const routes = generateRoutesBasedOnRole(userRole); // 生成动态路由
  routes.forEach(route => router.addRoute(route));
  // 添加后跳转到首页（需处理重复添加问题）
  router.replace({ path: '/' });
}

// 全局守卫中处理未加载路由的情况
router.beforeEach((to, from, next) => {
  if (!router.hasRoute(to.name) && to.meta.fallbackPage) {
    next(to.meta.fallbackPage); // 跳转到备用页
  } else {
    next();
  }
});

场景 2：数据预加载

在进入路由前获取必要数据：

// 路由配置
{
  path: '/article/:slug',
  component: ArticleDetail,
  meta: { preload: true }
}

// 全局守卫中预加载数据
router.beforeEach(async (to, from, next) => {
  if (to.meta.preload) {
    await store.dispatch('fetchArticle', to.params.slug);
  }
  next();
});

场景 3：滚动行为控制

结合 scrollBehavior 实现页面滚动位置管理：

// router.js
const router = new VueRouter({
  scrollBehavior(to, from, savedPosition) {
    if (savedPosition) {
      return savedPosition; // 浏览器前进/后退时恢复位置
    } else if (to.hash) {
      return { selector: to.hash }; // 处理锚点
    } else {
      return { x: 0, y: 0 }; // 默认顶部
    }
  }
});

---

四、常见问题与解决方案

1. 无限重定向循环

问题 ：守卫逻辑错误导致 next() 重复调用。
解决 ：确保守卫中有且仅有一次 next() 调用，避免重复跳转。

2. 动态路由刷新 404

问题 ：动态添加的路由在刷新后丢失。
解决 ：在应用初始化时（如 main.js）重新根据用户权限添加路由。

3. 异步守卫处理

问题 ：守卫中需要等待异步操作（如 API 请求）。
解决 ：使用 async/await 或返回 Promise：

beforeRouteEnter(to, from, next) {
  api.getData().then(data => {
    next(vm => vm.setData(data));
  });
}

---

五、最佳实践

1. 路由元信息 (meta)：标记路由的权限、是否需要缓存等。

2. 路由懒加载 ：提升应用性能。

   component: () => import('./views/UserProfile.vue')

3. 参数解耦 ：使用 props 代替直接访问 $route.params。

通过合理组合动态路由与导航守卫，可以实现高度灵活的路由控制，满足复杂业务场景需求。