组合式 API 中路由守卫通过 onBeforeRouteLeave 和 onBeforeRouteUpdate 实现组件级控制,结合 useRoute、useRouter 与 watch 动态响应,可封装为可复用组合函数,并在全局守卫中调用以兼顾灵活性与可维护性。

在组合式 API 中,路由守卫逻辑不靠组件选项写法(如 beforeRouteEnter),而是通过 Vue Router 提供的组合式 API 钩子 + 响应式状态协同实现。核心是把“守卫行为”从生命周期钩子中解耦出来,变成可复用、可测试、可响应式控制的逻辑单元。
用 onBeforeRouteLeave 和 onBeforeRouteUpdate 处理组件级守卫
这两个是专门用于组合式 API 的组件内守卫钩子,必须在 setup() 或 script setup 中调用:
-
onBeforeRouteLeave:当前路由即将被离开时触发(例如从/user/123跳转到/home) -
onBeforeRouteUpdate:当前路由参数变化但复用同一组件时触发(例如从/user/123切到/user/456)
它们接收一个回调函数,内部可执行校验、弹窗确认、中断导航等操作。注意:必须显式调用 next() 放行,或 next(false) 拦截(Vue Router 4.1+ 支持 Promise 风格返回)。
在 setup 中访问路由并做条件判断
借助 useRoute 和 useRouter,你可以在任意时机读取路由状态、发起跳转或干预流程:
-
const route = useRoute()获取当前路由对象(含params、query、meta等) -
const router = useRouter()获取导航能力(push、replace、back等) - 结合
watch监听route.params或route.meta变化,动态触发权限检查或数据重载
例如:进入用户页时检查 ID 是否合法,不合法则 router.replace('/404'),无需写在守卫里,更灵活。
封装可复用的守卫逻辑函数
把通用判断逻辑抽成独立组合函数,比如 useAuthGuard 或 useRoutePermission:
- 内部使用
useRoute读取目标路由元信息(如meta.requiredRoles) - 结合
useAuthStore(Pinia 或自定义 ref)获取当前角色/权限列表 - 返回一个
canAccess计算属性或校验函数,供onBeforeRouteLeave或页面逻辑调用
这样既保持逻辑集中,又避免在每个组件里重复写权限判断,也方便单元测试。
全局守卫仍需在 router 配置中注册,但可调用组合逻辑
全局前置守卫 router.beforeEach 本身不在组合式 API 范畴内,但它完全可以调用你封装好的组合函数:
- 在
router/index.ts中导入useAuthStore - 在
beforeEach回调里调用authStore.canAccess(to)判断 - 若权限未就绪,可
return authStore.loadPermissions().then(() => next())实现异步等待
这种混合方式兼顾了全局拦截能力和组合式 API 的可维护性。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










