vue路由守卫易错点

路由守卫易错点

1. 把 beforeEnterbeforeRouteLeave 用反

  • beforeEnter 是"进入某条路由前"的路由级守卫,适合鉴权、参数校验、重定向。
  • beforeRouteLeave 是"离开当前组件前"的组件级守卫,适合弹窗清理、未保存确认、资源释放。
  • 易错点:很多人用 beforeEnter 做离开清理,结果离开时根本不触发。

2. 误以为 beforeRouteEnter 能直接拿 this

  • beforeRouteEnter 执行时组件实例还没创建,所以没有 this
  • 正确用法是 next(vm => { ... }) 在实例创建后访问组件。
  • 对比:beforeRouteUpdatebeforeRouteLeave 可以直接用 this,因为组件已存在。

3. 误判触发时机:query/params 改变不一定会销毁组件

  • 同一路由下只改 query(如 ?tabname=tuan)常常是复用组件,不会重新创建实例。
  • 这时通常不会触发你期待的"进入新页面"逻辑,应该用:
  1. watch($route)watch(() => $route.query.xxx)
  2. beforeRouteUpdate
  • 易错点:把初始化逻辑只写在 created,导致切 query 后不刷新数据。

4. 忽略守卫层级顺序导致判断重复或冲突

  • 常见顺序理解:全局前置 beforeEach -> 路由独享 beforeEnter -> 组件内 beforeRouteEnter
  • 易错点:同一鉴权逻辑在三层都写,维护困难且可能互相覆盖重定向。
  • 建议:全局管"通用规则",路由独享管"页面特例",组件守卫管"组件状态"。

5. 在守卫里忘记放行

  • Vue Router 3 常见问题:调用了守卫却没 next(),页面卡死。
  • Vue Router 4 则常见返回值写错(应返回 true/false/redirect)。
  • 易错点:分支多时有漏掉的分支没放行。

6. 异步逻辑没处理好,造成闪跳或重复跳转

  • 守卫里发请求要注意异常分支。
  • 易错点:请求失败后既没中断也没降级,出现空白页或循环跳转。
  • 建议:统一兜底,失败时给明确去向(登录页/错误页)。

7. 组件离开清理不彻底,导致"脏状态"回流

  • 比如 Vuex 里的弹窗状态、筛选条件、临时编辑数据没清。
  • 你的项目就是典型正确示例:团课页在 beforeRouteLeave 里先关闭预约管理弹窗,再 next(),避免切走后状态残留。

8. 误用 beforeEnter 处理组件内部 tab 行为

  • /schedule/index?tabname=tuan 这种通常是同一路由容器内切换。
  • beforeEnter 只在进入该路由记录时触发,不是为组件内部 tab 切换设计的。
  • 这种场景应在组件里处理 query 到状态映射,必要时配合 beforeRouteUpdate 或 watcher。

9. 把"权限控制"和"UI 展示控制"混在一起

  • 权限控制应在守卫/路由层(是否允许进入)。
  • UI 展示控制应在组件层(是否展示按钮、tab、操作项)。
  • 易错点:只隐藏按钮不做路由校验,用户仍可直接输 URL 访问。

10. 不区分"路由守卫"与"生命周期钩子"

  • 守卫解决"是否允许这次导航、导航前后做什么"。
  • 生命周期解决"组件创建/更新/销毁时做什么"。
  • 易错点:把导航问题放在 mounted 里,导致先渲染后跳转,体验差。

实战记忆口诀

  1. 进页面拦截:beforeEnter / beforeEach
  2. 组件创建前:beforeRouteEnter(无 this,用 next(vm=>...)
  3. 同组件路由变化:beforeRouteUpdate
  4. 离开组件收尾:beforeRouteLeave

路由守卫最常见误区不是"不会写",而是"写在了错误层级和错误时机"。

先判断你要解决的是"路由进入权限""组件复用更新"还是"离开清理",再选守卫,问题会少一大半。