路由守卫易错点

1. 把 beforeEnter 和 beforeRouteLeave 用反

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

2. 误以为 beforeRouteEnter 能直接拿 this

• beforeRouteEnter 执行时组件实例还没创建，所以没有 this。
• 正确用法是 next(vm => { ... }) 在实例创建后访问组件。
• 对比：beforeRouteUpdate、beforeRouteLeave 可以直接用 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

路由守卫最常见误区不是“不会写”，而是“写在了错误层级和错误时机”。
先判断你要解决的是“路由进入权限”“组件复用更新”还是“离开清理”，再选守卫，问题会少一大半。